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ABSTRACT 


The development of distributed systems needs to consider multiple factors such as 
performance, scalability, resource sharing, and fault tolerance. This thesis proposes a 
simple agent-based framework to address these concerns when building distributed 
applications. Agents act as interfaces among processes that interact and cooperate in a 
distributed environment. These agents encapsulate the implementation details and make 
the network transparent to running processes. The proposed framework is built on JINI 
infrastructure. It uses Linda TupleSpace model, a shared network-accessible repository, 
for different processes to exchange information. Processes are loosely coupled. They 
discover and linkup with one another by using services residing on JINI infrastructure. 
Under the proposed model, the correspondent language wrappers such as Java, Ada, C++, 
C and Visual Basic support multiple programming languages. Information exchange 
among processes is not restricted to data only. Executable components, leveraging on 
Java code’s portability features, can be sent over a heterogeneous environment and 
executed remotely. 

This framework can further address several important issues on formal 
specifications of the communication layer, such as partial failure, synchronization, 
coordination and heterogeneity, by offering properties in our design for operation 
timeout, and information and service leasing. 

This framework is to be used in the Distributed Computer Aided Prototyping 
System (DCAPS) to provide the inter-process communication layer. It simplifies the 
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tasks of designing, binding and analyzing multiple processes of real-time, distributed 
prototype systems. 

The provided interface library shields the developer from working on the 
underlying dynamic and complex network environment. It supports a wide variety of 
programming languages and operating platforms. Important issues under distributed 
environment, such as partial failure, synchronization and coordination, have been taken 


into consideration. 
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I. INTRODUCTION 

In the past few years, the computing landscape has changed dramatically. More 
and more devices, such as hand-phones. Personal Device Assistances (PDAs) and 
Internet terminals, etc., have been enhanced with network capabilities to leverage on the 
benefits that new communication technologies have brought to us. Industrial companies 
and military services often operate and communicate via the Internet in a broad area to 
streamline operations and cut down on expenditure. Devices and software components 
have become more tightly coupled, cooperating together in a distributed system to 
accomplish a common goal. A distributed computer system is, therefore, defined to be a 
system of multiple autonomous processing elements, cooperating for a common purpose 
or to achieve a common goal ([Robert98]). Hence, challenges and concerns for 
constructing a distributed computer system have become a growing field that is being 
intensively studied worldwide in recent years. 

Distributed systems offer more benefits than standalone systems do. The 
computational ability of a standalone system is usually limited by the available power 
and resources in a single computer. Distributed applications can grow more easily to 
meet new demands by introducing more CPUs and memory. Expensive resources such 
as supercomputers and color printers can be shared and utilized by many different users. 
Distributed systems could reach a better fault tolerance and availability because both 
problems have to be carefully taken care of from the beginning of system design. Hence, 
unlike a standalone program, which could be totally terminated if any component in its 
system fails, a distributed application can still continue to operate even if some processes 
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get disrupted because of system failure. Distributed systems can also reuse a lot of 
legacy software components through re-engineering. 

Rewriting legacy software to run in a distributed environment tends to be 
prohibitively expensive and complexed. Many legacy software systems are expensive 
investments that have been developed over many years. Replacing them with new 
designs or implementations is usually not easy to justify in terms of costs and resource 
allocation. Although the only way to keep such legacy software useful is to incorporate 
them into a wider cooperating community in which they can be exploited by other pieces 
of software, in practice, this could be very complex in terms of design. 

Despite the benefits, building distributed applications is difficult. There are many 
different requirements and specifications for distributed systems. Developers have to 
face many problems that do not arise when building standalone applications. Besides 
some common problems like heterogeneity, latency, partial failure and synchronization, 
developers have to consider issues about how to make legacy software components “co¬ 
exist” with each other and how to “glue” multiple processes together running 
independently on different machines. 

Today, the technique to “glue” multiple processes running in a heterogeneous 
environment ranges from low-level sockets and messaging techniques to more 
sophisticated technology Object Resource Broker (ORB) [ORB91], such as CORBA and 
DCOM [DCOM96]. Many of these techniques require developers either to perform 
significant low-level coding work in constructing the communication mechanism or to 
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have a good knowledge of the interface details before designing. Hence, “gluing” pieces 
of processes is still a difficult task and requires skilful designers with expertise. 

Wrapper and Glue technology was proposed for constructing distributed systems. 
Wrapping is an approach to protect legacy software systems and commercial off-the-shelf 
(COTS) software products that requires no modification of those products. A wrapper 
consists of two parts, an adapter that provides some additional functionalities for an 
application program at key external interfaces, and an encapsulation mechanism that 
binds the adapter to the application and protects the combined components. Wrapping 
should require no changes to the existing application program. [MEESON97] Candidate 
mechanisms for implementation via wrappers: authentication, logging and auditing, 
constraint checking, encryption, access control, fault detection and recovery, redundancy. 
The glue plays another role by providing a uniformed, supporting layer for individual 
wrapped components based on their specific hardware and software configurations so 
that distributed systems are built upon the glue structure through which components 
communicate to each other. The developer does not have to go down to low-level 
communication details when developing the overall paradigm. 

This thesis proposes a simple framework using agents to act as interfaces among 

various processes that interact and cooperate in a distributed heterogeneous environment. 

It shields developers from the underlying dynamic and complex network environment, 

and offers developers a simple set of Application Program Interfaces (API) to build 

distributed applications. Developers, therefore, do not need to worry about their 

operating platforms and programming languages. It also provides an easier way for 

legacy software to share information with other applications in a heterogeneous 
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environment. The glue structure provided in this thesis not only gives APIs to realize the 
communication function across the platform, but also explores the real-time constraints 
and monitors for distributed system communications. 

This thesis is structured as follows. Chapter II introduces the benefits and 
challenges of distributed computing in detail and presents our survey of current 
technologies that are being used for constructing distributed applications. Chapter HI 
gives an overview of the proposed agent framework. The features and underlying design 
details of the agent framework are presented with respect to the requirements of real-time 
distributed systems. Chapter IV discusses the agent architecture and its implementation. 
In Chapter V, a test-bed application implemented using various language wrappers is 
presented to demonstrate the agent’s features. A more complicated application of an 
elevator control system has been constructed on the proposed agent structure. Future 
research directions are discussed in Chapter VI. 
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11. BACKGROUND 

This session discusses the benefits and challenges of building distributed 
applications. It also presents a list of technologies that are useful for designing and 
creating distributed systems. 

A. BENEFITS OF BUILDING DISTRIBUTED APPLICATIONS 

Distributed applications offer more benefits than standalone applications do in 
terms of performance, scalability, resource sharing, fault tolerance and availability. 

1. Performance 

Distributed applications can achieve better performance than standalone 
applications. Unlike standalone applications, which rely heavily on newer hardware to 
improve performance, distributed applications utilize the combination of systems 
connected together by a network to boost performance. This performance gain is often 
achieved through splitting problems into smaller pieces and then delivering them across 
the network, where they can be executed in parallel. Nevertheless, this category of 
problems is restricted to tasks that have a low communication-to-computation ratio, i.e. 
processes that spend much less time in communicating than in computing. Otherwise, 
any performance gain would be overwhelmed by the network latency. 

2. Scalability 

Distributed applications can scale more easily. Unlike standalone applications, 
where their scalabilities are limited by how much resource each system has, distributed 
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applications can grow without such constraint and new resources can be added to match 
the problem’s difficulties. 

3. Resource sharing 

Distributed applications allow organizations to fully utilize their available 
physical resources. For instance, expensive resources like supercomputers and color 
printers are difficult to redistribute, allowing each end user a local access might not be 
feasible. However, by making them as services more users can remotely access them and 
resource can be better utilized. 

4. Fault tolerance 

Non-distributed systems typically have little tolerance for failure. If a system that 
hosts standalone applications fails, these applications will terminate and remain 
unavailable until they are restarted. On the contrary, distributed applications can tolerate 
a limited amount of failure since they are built on multiple, independent processes that 
reside on many systems ~ if some processes fail, others can continue. 

B. CHALLENGES OF BUILDING DISTRIBUTED APPLICATIONS 

Despite their benefits, it is difficult to build distributed applications. The 
distributed environment introduces many problems that have not been taken care of in a 
standalone application’s development. These problems include heterogeneity, latency, 
partial failure, synchronization and coordination. 
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1. Heterogeneity 

Typically, a distributed application may have to reside on different platforms and 
use multiple technologies from various vendors to meet all requirements. Mixing them 
together usually creates new dimensions of difficulties in terms of integration and system 
management. Integrating multiple technologies can often result in incompatibilities that 
are beyond the control of designers. 

2. Latency 

Communication latency among processes over network is longer and less 
predictable than in a local system. The time lag is typically in several orders of magnitude 
compared to the communication among processes in the same system or to the speed of 
processors. Unlike a local system where user has better control over how resources are 
utilized, the user in a distributed system usually has no control on some resources, such 
as network usages. Hence, predicting the communication latency among processes that 
belong to a distributed application is much more complex and difficult. 

3. Partial failure 

Partial failure is the greatest challenge for designers building distributed systems. 
Unlike a standalone system, which is subjected to total failure, a distributed system is 
subjected to partial failure. If any of the components in the standalone system fails, the 
entire computation terminates. This type of failure is easy to detect and correct. 
Correction can be done simply by rebooting the system and follow by restarting the 
application. On the other hand, partial failure, if a component in the distributed system 
fails, some other processes of a distributed application can continues to run; very often 
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this is difficult to detect and control because resources like network are also being shared 
by many other applications. 

4. Synchronization 

In a distributed application, processes need to synchronize with one another to 
succeed a common task. For example, a distributed application often needs to mediate 
access to a limited set of shared resources, guarantee fair access to those resources, or 
prevent processes from terminating as they wait for resources that may never become 
available. Synchronization is not a problem for standalone applications because most of 
them are executed in sequence, and has a central resource manager, the operating system, 
which mediates access to critical resources. Designers building distributed applications 
have to build their own synchronization mechanism, which is difficult because processes 
are run independently on many machines that might have different architectures — if not 
done properly, it can easily result in a deadlock situation. 

5. Coordination 

Coordinating distributed processes can be difficult. An application that runs on a 
single machine has an operating system to act as a centralized manager to synchronize 
multiple threads. But in a network environment, a single point of control does not 
necessarily exist. Processes are executed on different machines and at their own pace. 
Unless we build a centralized controller to manage those processes, which might 
introduce an unwelcome bottleneck to the environment, we must build a distributed 
means of managing their interactions. 
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c. 


MODELS FOR BUILDING DISTRIBUTED SYSTEMS 


Distributed systems can be implemented using these models; namely, client/server 
model and distributed object model. 

1. Client/server model 

The Client/server model contains a set of server processes and client processes. A 
server process act as a resource manger for a collection of resources of a particular type 
such as database server, file server, print server and etc. A client process communicates 
with the server for the purpose of exchanging or retrieving information. Communication 
between the client and server can be achieved through sets of protocols agreed by both 
parties. 

The major drawback of the client/server model is that the control of individual 
resource is centralized at the server and this could create a potential bottleneck and a 
single point of failure. Although many implementations have tried to overcome this 
drawback by replicating storage data and functions across multiple servers, thus making 
duplicate server to either act as backup or serve different cluster of clients, this has 
introduced new problems in terms of maintaining data consistency in the servers. 

Despite the drawback, centralizing of resources at a few locations greatly 
simplifies the management of resources. Software update and maintenance are is much 
simple; administrators just need to concentrate on a few locations. 

The client/server model can be implemented in various ways. Typically, it is done 
using low-level sockets, remote procedure calls or high-level message oriented 
middleware such as message queues. 
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a. 


Sockets 


Sockets are low-level inter-process communication similar to file 
input/output. It requires developers to implement their own protocol through which the 
client and server will use to communicate with each other. 

b. Remote Procedure Call 

A Remote Procedure Call (RPC) is a high-level communication paradigm 
that allows network applications to be developed by way of specialized procedure calls. 
Client invokes a procedure call that sends requests to a remote server. When these 
requests arrive, the server calls a dispatch routine, executes the requested procedures, and 
returns the results to the client. Program control is returned to the client immediately after 
the RPC is completed. 

The major limitation of RPC is that it only offers synchronous data 
exchange between the calling program and called procedure. Developers must employ 
operating system features such as threads or subtasks to force the RPC to process in an 
asynchronous manner. Using RPCs to integrate applications also limits portability 
because the application code will become very dependent on the operating system. 

c. Message Oriented Middleware (MOM) 

MOM is primarily middleware that facilitates communication between 
distributed applications. While MOM supports both synchronous and asynchronous 
messaging, it is most closely identified with asynchronous messaging using queuing. 
MOM sends messages from one application to another using a queue as an interim step. 
Client messages are sent to a queue and remain there until they are retrieved by the server 
application. 
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The advantage of this system is that the server application does not need to 
be available when the message is sent. Instead, the server can retrieve the message at any 
time. In addition, since messages can be retrieved off the queue in any order, MOM can 
also facilitate retrieval of messages using priority or load-balancing schemes. MOM can 
also provide a level of fault-tolerance using persistent queues that allow messages to be 
recovered when the system fails. 

2. Distributed Object Model 

A distributed object-based system is a collection of objects that isolates requestors 
of services from providers of services (servers) by a well-defined encapsulating interface. 
Clients are isolated from the implementation of services as data representations and 
executable code. 

In a distributed object model, a client sends a message to an object that in turn 
interprets the message to decide what service to perform. This service could be performed 
either through the object or a broker. 

a. Distributed Object standards 

Distributed object systems such as CORBA, DCOM, and Java RMI 
provide the infrastructure for supporting remote object activation and remote method 
invocation in a client-transparent way. A client program obtains a pointer (or a reference) 
from a remote object, and invokes methods through that pointer as if the object resides in 
the client's own address space. The infrastructure takes care of all low-level issues such 
as packing the data in a standard format for heterogeneous environments (i.e., marshaling 
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and unmarshaling), maintaining the communication endpoints for message sending and 
receiving, and dispatching each method invocation to the target object. 

Among all different vendors for distributed object systems, CORBA is the 
most widely supported standard. Its main advantages are platform independence and open 
industry standard that contains over 750 industry members. 


D. JAVA LANGUAGE FOR DISTRIBUTED PROGRAMMING 

The major advantages of using Java programming language to write distributed 
applications are their platform independent and networking support. Unlike applications 
written in platform dependent programming languages such as C-H- and Ada languages, 
which must be compiled to their native platforms in order to run; Java applications need 
not be compiled and they can run on varieties of system architectures and software 
platforms as long as they have JVMs (Java virtual machines) [JVM96] installed to 
interpret the byte code during runtime. Java language is also the first general 
programming language that is designed specifically to work over the network, in 
particular the Internet. Java extensive library of routines for coping with TCP/IP 
protocols like HTTP and FTP make creating network connections much easier than in C 
or C++. Java applications can open and access objects across the net via URLs with the 
same ease that programmers are used to when accessing a local file system. 
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E. THE JINI TECHNOLOGIES 

JINI [KEI99] [JOY99] is one of a large number of distributed systems 
architectures including industry-pervasive system such as CORBA and DCOM. It is 
distinguished by being based on Java programming language and deriving many features 
that leverage on capabilities that this language provides, like object-oriented 
programming, code portability, RMI (Remote Method Invocation) [RMIOO], network 
support and security. 

Some of the features Jini Technologies offers are 

Enable users to share services and resources over a network 

Provide users easy access to resources anywhere on the network while 
allowing the network location of the user to change 

Simplify the task of building, maintaining, and altering a network of devices, 
software, and users 

Jini technology consists of a programming model and a runtime infrastructure. 
The programming model helps designers build reliable distributed systems as a federation 
of services and client programs. The runtime infrastructure resides on the network and 
provides mechanisms for adding, subtracting, locating, and accessing services as the 
system is used. Services use the runtime infrastructure to make themselves available 
when they join the network. A client uses the runtime infrastructure to locate and contact 
desired services. Once the services have been contacted, the client can use the 
programming model to enlist the help of the services in achieving the client's goals. 
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F. TUPLE SPACE MODEL 

Tuple Space model was first conceived in the mid-1980 at Yale University by 
professor David Gelemter under a project called Linda. Tuples are typed data structures. 
Collections of tuple exist in a shared repository called a tuple space. Coordination is 
achieved through communication taking place in a tuple space globally shared among 
several processes. Each process can access the tuple space by inserting, reading or 
withdrawing tuples. 

In this model, the programmer never has to be concerned with or program explicit 
message passing constructs and never has to manage the relatively rigid, point-to-point 
process topology induced by message passing. In contrast, coordination in Linda is 
uncoupled and anonymous. The first means that the acts of sending (producing) and 
receiving (consuming) data are independent (akin to buffered message passing). The 
second means that process identities are unimportant and, in particular, there is no need to 
"hard wire" them into the code. 

There are a few similar implementations like JINI/JavaSpaces, IBM’s Tspaces 
[TSPACESOO] and Cloudscape’s Java database [CLOUDOO], which are built based on 
TupleSpace model. All of them offer a simple mechanism for dynamic communication, 
coordination, and sharing of objects between clients and servers. 
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III. DESIGN 

This session gives an overview of the agent framework and describes its features 
and underlying design. 

A- OVERVIEW 



Figure 1 A distributed application using our agent framework 


This thesis proposes a simple framework using agents to act as interfaces among 
processes interacting and cooperating in a distributed environment. These agents 
encapsulate the implementation details and make the network transparent to processes. 
Hence, by using these agents, developers can reduce significantly their efforts in 
implementing the process interfaces and concentrate on building the logic portions of a 
distributed application. 
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Our framework is built on IINI infrastructure and uses JINI network technology 
to simplify the task of building and maintaining reliable distributed systems. This 
technology consists of a well-defined programming model, which allows us to create our 
own services and leverage on services that have already been built to support JINI 
infrastructure. Using this programming model, we do not have to worry about the low- 
ievel communication protocol Client processes can dynamically locate and access 
services held in the JINI community using its runtime infrastructure, even if they do not 
know their host URL addresses. 

Our framework uses Linda [GEL853 TupleSpace model type of communication 
mechanism for inter-process communications. Processes are loosely coupled, rather than 
through direct communication, they interact in a globally shared space - repository 
service provided by JavaSpace Service [JS99], through share variables - entries. Being 
loosely coupled, processes need not be physically connected all the time and do not have 
to worry about the point-to-point topology induced by message passing. Several 
processes residing on same machine or on different machines can access the repository 
simultaneously. They interact among themselves by means of reading, writing or 
consuming entries stored in the repository service. 

Repository service is a shared, network-accessible depot for entries storage. It 
behaves like a lightweight relational database, where agents acting on behalf of their 
processes can store, retrieve and query entries stored in it. Unlike database where users 
construct Structured Query Language (SQL) statements to query records, agents use pre- 
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constructed tempiates defined in our framework to match entries stored in the repository 
and only entries that match exactly the data types and fields defined in the template are 
returned by the repository' service. 

Entries are a collection of values or objects placed in repository service by 
coordinating processes for information sharing. Before a process can start operating on an 
entry, it first has to declare the entry, which is identified by a unique name and an entry 
type, with its agent; just like variables declaration in programming techniques. Entry type 
varies from simple primitive type like integer, float, double, etc to more complex type 
like queue, stack, list, etc where entries are managed as group. Each entry, upon 
declaration, is assigned an entry handier to serve operations for accessing the repository 
service. 

Entry handler is responsible for carrying out operations pertaining to a declared 
entry. There are many kinds of entry handlers. Each one is associated to an entry type and 
has methods designed specifically to handle a particular entry type. Methods that are 
common in all handlers are: read, write, take, update and notify. Processes mainly use 
them for manipulating entries stored in the repository service. Every entry handler 
consists of a set of attributes that determine how it carries out its operations. Many of 
them can be overwritten after entry declaration by processes to meet different application 
needs. For instance, an entry-leasing attribute, which determines the validity of the entry 
process stored in the repository, can be used in a real-time application to specify the 
deadline of information to prevent recipients from accessing obsolete information, which 
sometimes can be more damaging than not have any of them. 
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Establishing a session with agent service is done in two simple steps: firstly, 
locate the service and then perform a login registration. If the process knows the network 
location where agent service is held, the process can bypass the search procedures. 
Searching for services in JINI network is achieved using JINI’s discovery protocol - 
agent inserts a package into the network and wait for lookup services to respond. A 
lookup service provides the facility for services to publish their services. Upon receiving 
the request package, lookup services respond by returning a list of service items. Each 
item describes its service properties and functions. The agent then searches through the 
list, comparing their service attributes with those of the agent service. After it has found a 
matching service, it will proceed to establish a connection follow by a service registration 
providing a valid login ID and a password to the agent service. 

Below' is a summary of features the framework provides, 

A simple and yet comprehensive interface that allow multiple processes to get 
connected and interact with one another in a distributed environment. 

Processes can be implemented in Java, Visual Basic, C/C++, or Ada; two agent 
wrappers are included, ActiveX wrapper and a C library wrapper. 

Processes are loosely coupled; they need not be physically connected all the time 
and do not have to worry about the point-to-point topology induced by message 
passing. 
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Several processes residing on the same machine or the different machines can 
access the repository service and retrieve data simultaneously in a reliable 
manner. 

Agent Service provides authentication and controls mechanism to manage 
processes using its services. 

Avoid the needs to create and manage remote/virtual classes (e.g. stubs and 
skeletons in RMI and CORBA implementations) 

Provide callback mechanisms that invoke user-defined methods when conditions 
are met. 

Support transaction, which enforce consistency over a set of entry operations 
Support leasing, which prevent resources from growing out of bound. 

B. ENTRIES 

Entries are a collection of values or objects placed in the repository service by 
coordinating agents for information sharing. Every entry has a unique entry name and an 
entry type. Unique name differentiates an entry from those stored in the repository and 
entry type determines the contents placed inside the entry. We have grouped entries into 
three categories: shared variables, ordered structures and unordered structures. 

1. Shared variables 

Like variables in programming techniques, they provide storage for some values 
or objects; however, shared variables allow multiple processes operating in the virtual 
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space to access and modify them simultaneously in an atomic manner. Atomic operation 
prevents these entries from corruption caused by race conditions. Shared variable type 
can either be defined as Integer, Boolean, Float, Long, Double, String or User-defined. 
User-defined as the name implies allow developers to define their own data structure. 



Figure 2 Share Variables Entries 

2. Ordered structures 

Ordered structure entries are like containers, collecting of similar values or 
objects, in object-oriented languages, where process can iterate through them. There are 
three types of ordered structures defined, i.e., queue, stack, and listi Queue type operates 
in First In First Out (FIFO); a take operation consumes the first entry' in its group and a 
put operation deposits an entry to the last entry in its group. Stack type is similar to queue 
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type, except that the take operation consumes the most recent entry deposited. List type 
allows processes to search and iterate through the list of entries by using indexes. 
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Figure 3 Ordered Structure Entries 


3. Unordered structures 

An unordered structure behaves like a pack of entries with the same entry ID but 
without any internal order. Unlike ordered structures where they are read or written in a 
predetermined order, unordered structures are arbitrary read or written into the repository. 
A typical example is task-result bags; a process places many small pia:es of 
computational tasks in the task bag, waits for other processes to pick them up for 
computation and retrieves the results from the result bag placed after they have been 
computed. 
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Figure 4 Unordered Structure Entries 


C. AGENT SERVICE 

Agent service provides authentication and controls mechanism for processes 
running in the network environment. It forces every process using its service to go 
through an authentication process, verifying their identifications against those held inside 
its service database. Identifications can be added or removed from its database to control 
process accesses to restricted resources. It includes a control mechanism that helps itself 
recover resources held by non-existing processes. This mechanism will periodically 
check the status of all processes using the agent service. When it discovers a process that 
is no longer existing (leasing expired), it frees up the resources and assigns them to other 
processes. 

D. AGENT OPERATIONS 

Agent interfaces offer processes a simple and yet comprehensive set of operations 
to interact w'ith one another in a distributed environment, from establishing of 
connections to handling of entries. Generally, we have grouped them into 5 types of 







operations: service registration operations, entry operations, transaction operations, 
event-handling operations and advance operations. 

1. Service registration operations 

Service registration operations provide processes the means to discover and 
register with agent service as well as to retrieve the handles of common services. Figure 5 
shows a service registration process. To begin, a process first has to locate a lookup 
service that agent service publishes itself. Lookup service is like a name directory, 
providing facility for services to publish themselves whereby clients can easily locate 
them. If the process knows exactly where the agent service is located, it can proceed 
directly to service registration, otherwise, it has to perform a network search using JINI 
discovery protocol - place a request package onto the network and wait for lookup 
services to response. After registration the process can retrieve the handles of services 
needed for inter-process communication such as transaction service, JavaSpace service 
and etc. 
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2. Entry operations 

Entr>' operations allow processes to manipulate entries store in the repository 
service. There are five kinds of entry operations that the agent interface provides, namely: 
read, write, update, take and notify. A read operation and a take operation, as depicted in 
figure 6a & 6b, allow processes to retrieve a copy of an entry that matches a given 
template stored in the repository. Unlike a read operation, a take operation will remove 
the entry from the repository after retrieving. On the other hand, a write operation places 
a new entry in the repository while an update operation overwrites any existing entries 
having the same entry ID. The Notify operation, shown in figure 6e, allows process to 
monitor for incoming entries to the repository - when a new entry is added and matches 
the entry ID being monitored, process would be notified by an event. 
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Figure 6c Entry Write Operation 
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Figure 6d Entry Update Operation 



Every entry operation that process performs is constrained by a set of entry 
attributes that is described in details in session III-E. For instance, these attributes limit 
how long a read operation should wait for an entry if it is not available in the repository, 
how long an entry should remain valid l^fore being removed away from the repository 
and etc. Although these attributes are preloaded during declaration, designers can change 
them to meet individual application needs. 

3. Transaction operations 

Transaction operations allow processes to enforce consistency over a set of entry 
operations. When a process starts a transaction, entry operations carry out under this 
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transaction will be considered as a group operation. If the transaction completes 
successfully, then all entry operations associated to it are considered completed. 
However, if any problem arises in one of the operations, then the transaction would be 
aborted and all other operations are cancelled. Though using transaction would decrease 
the response time of entry operations, it helps to address one of the most difficult issues 
in distributed environment - partial failure. 




Figure 7 Entry Operations with Transaction 


As depicted in Figure 7, in order to bind entry operations with a transaction, the 
agent first has to request for a handle from the transaction service. Subsequently, it passes 
this handle along with other required parameters to carry out the entry operations. Every 
handle comes with an expiring time - it automatically terminates the transaction if 
operations issued are not completed within a given time. When the agent completes its 
entry operations, it has to inform the transaction service to close the transaction. 


4. Event Handling 

When a new entry arrives, the repository service creates a notification event. The 
event Handling allows processes to be triggered by notification event. For a process to be 
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triggered, it first has to invoke a notify operation, specifying the entry it wishes to 
monitor and the callback routine it defines to handle the trigger. The agent, upon 
receiving a notification event, performs some internal filtering and sorting to determine 
the owner and then triggers the callback routine. 



Figure 8 Event Handling 


Event notification is especially important in a distributed system. Rather than 
“busy waiting” for an entry to arrive in the repository service through polling, which is a 
burden to the entire network load, processes can make use of notification operation 
whereby a user-defined routine would be called when conditions are satisfied. 

However, in our current design we do not guarantee the delivery of all notification 
events raise by the service. In the worst case, where system fails or network congestion 
occurs, a notification event package might not reach its destination. Since no 
acknowledgment is returned to the sender, the notification event is considered lost. One 

It- 

way to overcome this problem is to use an event mailbox service, which keeps a copy of 
all outgoing events and keep delivering the event until the recipient acknowledges. 




5. 


Code Serialization 


Leveraging on the Java code portability, our agent contains some operations that 
allow processes to embed codes into entries for executing in other processes. It performs 
the function of packing codes into entries and resembles the code in the agent for 
execution, as shown Figure 9. 



E. AGENT ATTRIBUTES 

Agent Attributes affect how the agent carries out its operations. Two of the 
attributes are le^e time and time out, and they are applied in many areas. The designer 
can change the default attribute setting after initializing the agent to meet individual 
application needs. 

1. Leasing 

Leasing ensures that the resources used will not grow out of bound. Especially, in 
an environment where partial failure is frequent and processes are disconnected from the 
resources and cannot explicitly free them. A lease must be renewed before it expires, 
otherwise, the resources that have been requested under this lease will be released. 
Transparent to developers, the agent service has to periodically renew its lease with 
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JINI/lookup service to maint^n the interest in using its facilities to publish its service. It 
is similar for agents to renew its lease in the agent service. 



Figure 10 Renewing Service Lease 


Every entry posted to space must be leased. By default it is given a lease of one 
minute. After the lease time expired, the service will free the resource occupied by the 
entry. Similarly, the transaction service will abort all transaction requests right after the 
lease expires. 



Figure 11 Entry Lease Expired 
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Developers must provide due consideration towards leasing while developing the 
application. Although the developer can set a longer lease time that would not expire, this 
could put some constraints on services that still have to maintain the resource used when 
the owner has been disconnected from the network and cannot explicitly free them. 

2. Timeout 

In a distributed environment, it is difficult to determine whether a process 
becomes unavailable due to a system failure or because the CPU is busy with some other 
jobs. Timeout offers the means for the process to give up its operations and turn to other 
jobs. Without timeout, process could be deadlocked to an operation when a certain 
system failure occurs, i.e., waiting endlessly until someone intervenes. Figure 13 and 
Figure 14 show diagrams of service timeout and Entry ReadAVrite operation timeout 
respectively. 
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F. AGENT WRAPPERS 

There are many compelling reasons for the agent to support a wider variety of 
programming languages. Some of these reasons are software re-use, integration with 
legacy code, leveraging on tools that are not available for a particular programming 
language, and performing low-level activities such as hardware interface. 

In the thesis, we provide two types of agent wrappers, ActiveX Component 
Wrapper and Native C Library wrapper. ActiveX Component Wrapper allows our agents 
to be encapsulated as objects in Visual Basic, Visual C-h- or Microsoft Office 
applications running in Microsoft Window platform, whereas Native C Library Wrapper 
allows our agent to be bound together with native languages such as Ada, C and C-H-. 
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Figure 15 Agent Wrappers 
















IV. IMPLEMENTATION 

This session describes our framework architecture and its implementation details. 

A. ARCHITECTURE 



Figure 16 Agent Architecture 


Our agent architecture, as depicted in Figure 17, consists of six main modules. 


They are Agent Service module. Service Re^stration module, Agent Merface module. 
Event Module, Transaction Module and Agent Wrapper module. Agent Service module 
implements a service to manage and control the access of agents into the network 
environment. Service Registration module offers the means for processes to locate and 
register with the agent service. Agent Interface module provides processes a simple 
interface to access the agent operations. The Event module handles notification event 
issued by the repository service when new entry arrives at the repository. Transaction 


Module supports the entry operations with transaction services. Lastly, Agent Wrappers 
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expose the interfaces of the agent to processes written in other languages such as Ada, C, 
C++ and Visual Basic/C++ 

B. AGENT SERVICE MODULE 

Agent service module implements authentication and conlrol mechanism for 

processes running in the network environment. It also publishes an agentSeiyice interface 

to inform clients what methods are available in the service where they invoke. The 

agentService interface class consists of two methods, joinService and endService. 

JoinService method allows client to linkup with agent service and endService terminates 

connection with service. The JoinService method takes 2 parameters, a name and a 

password. Both parameters are used to verify the client identification and must match one 

of the records held inside its service database. 

public interface agentService { 

public boolean joinService(String name, String Password); 
public boolean endServiceQ; 

} 

C. SERVICE REGISTRATION MODLXE 

Service Registration Module offers the means for the process to locate and 
register with the service. It composes of two classes: ServiceAccessor and ServiceFinder. 
ServiceAccessor class provides the method for processes to discover and register with 
services in the JINI community. ServiceFinder class, on the other hand, helps the 
ServiceAccessor to determine whether a request exists in a list of services that it has 
discovered. 
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Figure 17 Service Registration Module 

1. Service Accessor 

ServiceAccessor class provides the method for processes to discover and register 
with services in the JINI community. Service discovery is done using the GetLocator 
method and service registration is performed using the getService method. 

public class ServiceAccessor implements java.io.Seriaiizabie{ 
public static Locator getLocator( long iookupTimeout) 
public static AgentService getAgent() 
public static AgentService getAgent(String name) 
public static JavaSpace getSpace() 
public static JavaSpace getSpace(String name) 
public static TransactionManager getTransaction () 
public static TransactionManager getTransaction (String name) 

} 


GetLocator method takes one parameter - timeout, which defines a maximum 
time (in millisecond) that it can spend searching for a lookup service (a facility where 
services in the JINI community publish their services). If it fails to locate one within a 


given time, an exception is returned to the calling process. 


G&tService methods (e.g. getAgent, getSpace and getTransaction) return the 
handle of services that a process has registered with, otherwise they return a null value. 
These methods require processes to provide names that can identify the services if they 
are being setup using different names. 
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Service Finder 


ServiceFinder class provides a method, find, for ServiceAccessor to determine 
whether a requested service exists in the list of services that it has discovered. The find 
method takes three parameters —locator, name and timeout. Locator is a valid lookup 
service handle where the request service is likely to have registered. Name is a string that 
identifies the requested service. Timeout is the time in millisecond that limits the search 
duration. 

public class ServiceFinder extends Finder { 
public Service RnderO {} 

public Object find (Locator locator, String name, long timeout) { 

D. EVENT MODULE 

The event module composes of three classes: SpaceEventRegistration, 
SpaceEventListener and SpaceActionHandler. SpaceEventRegistration class registers a 
notification event with the repository service. SpaceEventListener class monitors 
notification events generated from the repository service. SpaceActionHandler class 
analyzes the notification events and takes appropriate actions 



Figure 18 Event Module 


1. Space Event Registration 

The SpaceEventRegistration class is an interface responsible for registering 
notification event with the repository service to monitor new entries written into the 
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space by other cooperating agents. Every entry handler implements this interface to 
provide a consistent way of starting and stopping notification events. This class consists 
of two types of abstract methods: startEvent and stopEvent. 

public interface SpaceEventRegistration 

{ 

public abstract boolean startEvent(): 

public abstract boolean startEventl (SpaceActionHandler spaceAction); 

public abstract boolean startEvent2(SpaceActionHandler spaceAction, long lease); 

public abstract boolean startEvent3(SpaceActionHandler spaceAction, long lease , 
Transaction txn); 

public abstract boolean stopEvent(); 

} 

StartEvent method takes three parameters (if not specified, the default values will 
be used): SpaceActionHandler, Lease and Transaction. SpaceActionHandler is a valid 
object that is assigned to handle the notification event. Lease determines the expiring 
time in millisecond for a notification. Transaction is a valid handle, requested from 
JinL/Transaction service if a transaction is invoked. StopEvent method removes the event 
registration from the Repository service. It returns an exception if it fails to remove the 
registration or if the registration is already expired. 

2. Space Event Listener 

The Space Event listener class listens to events issued by the repository service. 
It implements a RemoteEventListener interface, which includes a notify method that the 
repository service used for raising remote events when new entries arri ve at its repository. 
The constructor has three parameters: entryType, entrylD, and SpaceActionHandler 
object. Both entryType and entrylD are required to identify the entry being monitored. 
SpaceActionHandle is a valid object that implements the SpaceActionHandler interface 
for handling of notification events. 
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public class SpaceEventListener implements RemoteEventListener { 
private int eventType; 
private String eventID; 
private SpaceActionHandler action; 

public SpaceEventListener(int entryType, String entrylD, SpaceActionHandler action) 
throws RemoteException 
public void notify(RemoteEvent ev) 

} 


3. Space Action handier 

SpaceActionHandler is a simple interface class with an abstract ActionPerformed 
method and fire method. The agent implements this interface to handle notification event. 
ActionPerformed is a callback method that encapsulates actions for handling of the 
notification events; any class implementing this interface must overwrite the 
actionPerformed method. The ActionPerformed method is triggered every time 
SpaceEventListener invokes the^re method, together with an entryType and entrylD to 
identify the entry that cause the notification. 

public interface SpaceActionHandler extends ActionListener { 
public void actionPerformed(ActionEvent e); 
public void fire(int entryType, String entrylD); 

} 


E. INTERFACE MODULE 

The interface module composes of three sub-modules: Application Interface, 
Entry Handlers and Entry templates. Application Interface provides a simple interface for 
the process to access the agent’s functions. Entry Handlers allow the process to carry out 
operations pertaining to the declared entries. Entry templates are used for retrieving 
entries from the repository service. 
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Figure 19 Agent Interface Module 


1. Application Interface 

The application Interface provides a simple way for processes to access the 
agent’s operations. Hiis interface can be sub-divided into 3 groups of methods: agent 
configuration, entry declaration, transaction handling. 

a. Agent configuration 

Agent configuration methods allow processes to change the setup 
properties as well as to initialize and to terminate connections with the services. Many of 
these properties determine how connections with the services are setup, thus changing 
these properties has to be done before invoking the initAgent method. In total, there are 6 
properties that are modifiable: AgentSecurityPolicy, AgentServerCodebase, 
AgentSpaceName, AgeniLookupGroup, AgentSecurityPolicy and AgentLookupURL 
Modifying and reading these properties can be done using their respective 
serAgentProperty and ggrAgentProperty methods. AgentSecurityPolicy property defines a 
policy file that controls all security permissions granted to the JVM. 
AgentServerCodebase property specifies the location of the code server where agents can 
download the required codes. AgentSpaceName property denotes the name of the 
repository service. AgeniLookupGroup property indicates the group type to join in, either 
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public or private. And AgentLookupURL property defines the location of the repository 
service that the agent should start looking for this service. 

InitAgent method allows a process to establish connections with services; 
this has to be done explicitly after the process has started. TerminateAgent method gives 
the system a chance to release allocated resources and relinquish service connections 
before a process ends. Processes written in other languages besides Java Programming 
languages have to explicitly call this method before termination to prevent any possible 
memory' leaks. 

public class Agent implements java.io.Serializable, SpaceActionHandier, TSConstants 

{ 


// System setting 

public void setAgentSecurityPoiicy(Stnng str) 
public void setAgentSpaceName(String str) 
public void setAgentServerCodebase(String str) 
public void setAgentLookupGroup(String str 
public void setAgentLookupURL(String str) 

public String getAgentSecurityPolicyO 
public String getAgentSpaceName) 
public String getAgentServerCodebase) 
public String getAgentLookupGroup 
public String getAgentLookupURL() 

public boolean lnitAgent{long timeout) 
public void TerminateAgentQ 


} 


b. Entry declaration 

Entry declaration methods allow a process to declare entries it wants to 

share with other processes running in the network. There are three methods provided, 

namely createlD, removelD and getTSObjec. CreatelD method creates a new entry 

handler to manage the declared entry. It takes 2 input parameters, entrylD and entryType. 
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Entry ID must be a unique string and entryType must be one of the following enumerate 
types: TS_BOOLEAN, TS_INTEGER, TS_FLOAT, TS_DOUBLE, TS.LONG, 

TS_STRING, TS_HASH, TS_QUEUE, TS_UST or TS.STACK. Each enumerate type 
symbolize the kind of entry the process wants to create. RemovelD method purges the 
entry handler that had been created. Both CreatelD and RemovelD methods return a true 
value if they succeeded in completing the actions, otherw'ise they return a false value. 
GetTSObject method returns the handle of an entry handler only if the handler exists. 


Otherwise, it returns a null value indicating an error has occurred. 

public class Agent implements |ava.io.Serializabie, SpaceActionHandler, TSConstants 

{ 

private Map tsStringMap; 
private Map tsBooleanMap; 
private Map teIntegerMap; 
private Map tsFloatMap; 
private Map tsLongMap; 
private Map tsDoubleMap: 
private Map tsQueueMap; 
private Map tsStackMap; 
private Map tsLinkListMap; 
private Map tsHashMap; 


public boolean create!D(int entryType, String entrylD) 
public boolean remove!D(int entryType, String entrylD} 
public Object getTSObject(int entryType, String entrylD) . 


c. Transaction handling 

Transaction handling methods allow a process to start, stop, abort and 
query transaction. StartTransaction method starts a new transaction, registers a 
transaction request with the running transaction service. CloseTransaction completes the 
transaction, commits all entry operations that have been carried after the start transaction 
and relinquishes the transaction handle. GetTransaction method returns the current 
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transaction handle. AbortTransaction terminates the transaction; all the entry- operations 
that have been invoked are cancelled. 

To perform a transaction, the process first has to invoke the 
startTransaction method, where the agent would then get the transaction handle using 
getTransaction methods, and then to pass it together with every entry operation that is 
executed under this transaction. Finally, the process should invoke a closeTransaction 
method to commit the transaction. If any operation fails to complete or the transaction’s 
duration fall beyond the given lease time, all issues that the operations have defined will 
be recalled. 

public class Agent implements java.io.Serializable. SpaceActionHandler. TSConstants 

{ 

public boolean abortTransaction() 
public boolean closeTransaction 
public boolean startTransaction() 
public Transaction getTransaction() 
public boolean isTransactionStarted() 

1 

2. Entry Handlei^ 

Entry Handlers allow processes to carry out operations pertaining to their entries. 
In total, there are 10 types of entry handlers; each corresponds to an entry type. For 
instance, an integer handier (TSInieger) corresponds to an integer entry {Entryinteger), 
offering methods needed to operate an integer entry in the repository service. 
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Figure 20 Entry Handlers 


Every Entry Handler inherits from a base class, TSBase. This class contains a list 
of entry attributes that determine how its entry behaves or how it should handle entry 
within the repository service. Upon initializing, these attributes are preloaded with default 


values. Processes can easily modify and query them by invoking dieir respective 

setAttribute and gtxAttribute methods. For example, to change or to check read-timeout 

attribute, a process can invoke selReadTimeoiit and getReadTimeOut respectively. 

public class TSBase implements java.io.Serializab!e{ 
public TSBaseO { 

writeLeaseTime = Lease.FOREVER: 
updateLeaseTime = Lease.FOREVER; 
notif^easeTime = 10000; 
readlimeOut = Long.MAX_VALUE; 
takeTimeOut = Long.MAX_VALUE; 

} 

public void setJavaSpace(JavaSpace space) 

public void setSpaceActionHandler( SpaceActionHandler spaceAction) 

public void setTransactionHandler( Transaction trans) 

public void setWrrteLeaseTime{long leaseTime) 

public void setUpdateLeaseTime(!ong leaseTime) 

public void setReadTimeOut(long timeOut) 

public void setTakeTimeOut(long timeOut) 

public Transaction getTransactionHandler() 
public long getWriteLeaseT»ne(){ 
public long getUpdateLeaseTime(){ 
public long getReadTimeOut() 
public long getTakeTimeOutQ 

} 































Every Entry Handler contains a common set of methods, but with some variation 
in input parameters depending on its entry type. These methods are readIfExists, 
takelfExists, write, update, startEvent and stopEvent. ReadIfExists method returns the 
entry value if it manages to find the request entry from the repository service. Similarly, 
takelfExists also returns the entry value but would remove the request entry from the 
repository service. Both methods take up to two input parameters: timeOut and 
transaction. The value of Timeout deteraiines how long the handler should wait for an 
entry if it is available but still being held back by the repository service because of a 
transaction operation in progress. Transaction is a handle provided by transaction service 
to cany out a transaction. Both write and update methods create a new entry that contains 
an entr>' value and put it into the repository service. Unlike write method, which just adds 
a new entry to the repository service; update method removes any existing entries, having 
the same entry name before placing a new one. Lease and transaction inputs are optional. 
Lease determines how long an entry remains valid in the repository service, after this 
time it would be automatically remove from repository. StartEvent and stopEvent 
methods allow a process to register and terminate entry notification with the repository 
service respectively. 

public class TSEntryType extends TSBase implements java.io.Seriali 2 able, 
SpaceEventRegistration, TSConstants{ 

{ 

public boolean writel {dataType value) 

public boolean write2(daraType value, long lease) 

public boolean write3(dataTypevalue, long lease, Transaction txn) 

public boolean updatel (dateType value) 

public boolean update2(dateTypevalue, long lease) 

public boolean update3( date Type value, long lease. Transaction txn) 

public dataType readlfExists{) 

public dataType readIfExistsI (long timeOut) 

public dataType readlfExists2{long timeOut, Transaction txn) 
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public datatype takelfExists() 

public dafaType takelfExists1( long timeOut) 

public dafaType takeIfExists2( long timeOut, Transaction txn) 

public boolean startEvent() 

public boolean startEventI (SpaceActionHandier spaceAction) 

public boolean startEvent2(SpaceActionHand!er spaceAction, long lease) 

public boolean startEvent3{Space Action Handier spaceAction, long lease , 

Transaction txn) 
public boolean stopEvent() 


} 

3. Entries 

Entries are serialized Java object instances that are stored within the repository 
service, where processes used them as a means to share information. In total, there are 10 
types of common entries created ranging from primitive type entry' like integer entry to 
more complex type entry like list and queue entry. Each entry class implements the Entry 
interface found in the net.jinni.core.entry.Entry package. 


Below is an example of an entry class - EntryHash. Entry Hash allows a process to 
define its own data structure. Its constructor takes one parameter or two parameters: 
entrylD and map Object (Optional). The EntrylD identifies the entry placed in the 
repository service and the map object is a container that holds the data fields defined by 
the process. 


public class EntryHash implements Entry { 
public EntryHash(String entrylD) 
public EntryHash(String entrylD, HashMap map) 
public HashMap getHashMapQ 
public void setHashMap(HashMap map) 

} 
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Figure 21 Entries 


F. AGENT WRAPPER MODULES 

The Agent wrapper module consists of two separate components: ActiveX 
wrapper and C Library wrapper. ActiveX wrapper embeds the agent as an object such 
that processes written in Visual Basic, Visual C-h- or Microsoft Office applications 
running in the Window environment can call it. C Library wrapper allows the agent to be 
bound together with processes written using machine dependents languages like C, C++ 
or Ada. 



Figure 22 Agent Wrapper Module 

The ActiveX Wrapper is implemented by using a packager, ActiveX Packager for 

Java Bean, that comes along with JVM plug-in provided by the Sun MicroSystem. This 

packager automatically generates the wrapper for any Java bean by going through the 

procedure of pre-compiling. Two files are eventually generated after the process, an OCX 

(OLE Control Extension) and a TLB (T>'pe LiBrary). To make the OCX available to the 

Window environment, developers should explicitly register them in the window registry. 
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Together with the Java Bean Bridge and JVM (Java Runtime Environment), any 
method calls on this OCX component will marshal over the bridge and gets executed in 
the JRE memory space; the return for the function is unmarshaled by the bridge and 


given back to the OCX component. 

The C Library Wrapper is built by using JNI (Java Native Interface) APIs. The 
procedure is more complicated and tedious than that of ActiveX Wrapper. We have to 
map every Java types to C, create corresponding interfaces in C language for every 
method defined, and manage the memory resources to prevent any memory leak. 
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V. RESULTS 

This session presents the results of an experiment conducted to measure the 
response time of JEsWJavaSpace service for inter-process communications. It also 
provides some guidelines on constructing a distributed system by using the proposed 
agent ffameworL An Elevator Control System (ECS) is developed as an example. 

A. SERVICE RESPONSE TIME 

Chart 1 and Chart 2, as depicted in Figure 23 and Figure 24 respectively, show the 
response times of the JINI/JavaSpace Service that we have tested over a local area 
network on two Pentium DI/SOOMHz machines. One machine is loaded with Jini 
Services (including Agent Service, Lookup Service, Transaction Service and JavaSpace 
Service) and the other is loaded with a client program making requests with Jini Services. 
The local area network traffic is pretty light - it takes an average latency time of 0.6 
milisecond for a 512 bytes data package to travel across the network from one machine to 
the other machine when using sockets. 

Both experiment are performed over the duration of 2 minutes with a total of 
1,0(X) test cases. Each case consists of 5 roundtrip requests, 5 read and 5 write operations. 
Roundtrip response time, time between the issue of a complete write operation follow by 
a successful read operation, was measured by taking the average of 5 roundtrip requests. 
The result of each case was taken and plotted on the charts below. 

The average roundtrip respond times in Chart 1 (1,000 tuples in the repository) 
and Chart 2 (10,0(X) tuples in repository) are 12.4 milisecond and 12.03 milisecond 
respectively. Chart 2, despite having more tuples, has a lower average roundtrip respond 
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time. We believe that it is due to fluctuation in the network traffic rather than changes in 
system performance. 


JavaSpace Service Response Time 
(1,000 tuples in repository) 



Server 

1 F^ntiumB^SOOIVHz 
128^©ytes Memory 

Test Cases 
Total No. :1000 
Duration : 120 Sec 

Response Time(msec> 
Best : 10 
Worst ; 37 
Average : 12.4 
StdDev. ;2.28 


Figure 23 Chart 1 JTNI/JavaSpace Response Time 


Service Response Time 
(10,000 tuples in repository) 


Server 



Figure 24 Chart 2 JINFJavaSpace Response Time 
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B. DEVELOPMENT GUTOELINES 

The following presents some guidelines on how to develop distributed 

applications using our agent framework; developers are advised to try out the test 
programs to get familiarized with the features that our framework provides. 

1. Identify the number of independent processes required for an application. 
They can either reside on the same machine or on different machines but must 
share a common network. 

2. Determine the number of entries and their types need to be defined in the 
repository service whereby different processes can use them for exchanging 
information. 

3. Use the appropriate wrapper if processes are written in other languages 
besides Java Language. ActiveX wrapper for Delphi, Visual Basic and Visual 
V++ processes, and C Libraiy wrapper for C, C++ and Ada processes. 

4. Within every process, 

a. Instantiate an agent 

b. Update the s>^tem setting; Agent Service, Security Policy file. Server 
Codebase, Lookup Group and Lookup URL before establishing 
connections with the services. 

c. Invoke initAgent method to establish connections with the services. It 
takes up to a maximum of 20 seconds to establish a connection. 
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d. Declare all entries, defined earlier, with the instantiated agent. Every 
entry declared has to be identified by a unique name otherwise it will 
overwrite any earlier declaration. 

5. Use the appropriate entry operation to access entries stored in the repository 
service. It is important to minimize the number of operations as far as possible 
since the network latency is about 10 miliseconds as compared to a few 
nanoseconds for accessing a local shared variable within a process. 

C. TESTING JINI/SERVICES 

We have created 3 test programs, which are written in different languages, to test 
the configurations of services and client processes. Figure 25a, 25b and 25c showed the 
screen captures of these test programs that are implemented in Java language. Visual 
Basic language and C language respectively. Each test program is a GUI component 
enhanced by an agent. These test programs consist of many useful functions described in 
the framework. Besides using them for testing the configurations, they can also be used to 
demonstrate how our framework works. 

We also included a simple script in Appendix B to simplify the complicated 
process of setting up the JINI/Services. Designers can load this script with JINI service 
starter toolkits provided by the Sun Microsystems to start the services. A detailed 
description on how to setup JINI Services can also be found in [KEI99]. 

After all the JINI services have been started, run any of the test programs on a 
separate machine anywhere in the network. Updates the agent setting, if the setup 
parameters are different from the default values, and then press the “initAgents” button to 
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establish connection with the agent service. If successful it will return a “service 
connected” message. Otherwise, it returns an error message indicating the problem 
encountered during initialization. 



Figure 25a Agent Test Bench (Java Language version) 
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Figure 25b Agent Test Bench (Visual Basic Language version) 


Enter connandt tt;pe:SIHING IB:ISString 3 “->x 
Enter Object IP ~'>ISString 

Leoel 1 Help 






set object ti;pe 
set object IP 
i'enove object 
create object 
list aXi objects 
start transaction 
abort transaction 
close transaction 
cfuit 

Cs"pace3 : NEXT level 

Enter connandC type:SIRIHG IBrXSString 3 ~>t 
C03:IHIEGEK XlIcFbOftl i:23:LOHG !:33:POUBLE i:43:STRIHG 

E53:QUEUE C63:SlfiCK l[73:I*IHKLISX IBlzmSH £93:BOOLERH 

£nter Ob^ect XE^g-z:^...^^ 


Figure 25c Agent Test Bench (C Language version) 
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D. AN EXAMPLE: AN ELEVATOR CONTROL SYSTEM 

We have designed a simple elevator control system (ECS) to demonstrate how 
distributed applications containing processes written in different programming languages, 
use our agent framework. Table 1 gives a brief description of the ECS requirements. 
Figure 26 is a state chart of the ECS, explaining the various operating states inside the 
system. It also shows the required commands to transit between states, the input guards 
for each command, if any, and the time duration to operate each state. 

We have divided the ECS into six independent processes; one scheduler, two 
hardware emulators, two control panels, one floor panel. The Scheduler determines an 
optimal solution to schedule the two elevators as well as monitors, and dispatches the 
commands to the hardware emulators. The Hardware emulator simulates the timing and 
sequences that an actual controller would need to control its hardware. The Control panel 
provides the interface for passengers to select their destinations, controls the closing and 
opening of the elevator door, and views the status of the elevator. Floor panel allows 
passenger to request for the elevator at each floor. 

Each of the six processes is designed to run on a different machine and to use the 
agents to interact with one another. Four processes (two hardware emulators and two 
control panels) are written in Java programming language. One process (floor control) is 
written in Visual Basic language with ActiveX agent wrapper. The last process 
(scheduler) is written in ANSI C language with C agent wrapper. We will only illustrate 
in this thesis how we design the process interface and the shared data, the details on how 
to build the lo^cal portions of each process in relation to the ECS functionality will not 

be discussed. Screen captures of the final product is shown in Figures 28A-28D. 
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ECS Requirements 

The elevator control system controls 2 elevators in a building consisting of JO floors. It 
schedules elevators to respond to requests from passengers at various floors and controls the motion 
of the elevators between floors. 

Inside each elevator, there is a set of elevator buttons and lamps: 10 floor buttons for the 
passengers to select their destination, an "'open"' button to keep the door open, a "close" button to 
close the elevator door, and 10 floor lamps to indicate either the current floor if the elevator is 
stationary or the arriving floor if the elevator is in motion. Each elevator also has a motor that is 
controlled by commands to open attd close the door. 

At the second to the ninth floor, there is a pair of "up" and "down" call buttons for 
passengers to request for an elevator. A corresponding pair of lamps will indicate the directions that 
have been requested. There are only an '"up" button and an "up" lamp in the first floor and only a 
"down" button and a "down" lamp in the tenth floor. 

At each floor for each elevator, there is a pair of direction lamps to indicate whether an 
arriving elevator is heading in the up or down direction. For the top and the bottom floors, there is 
only one direction lamp per elevator. There is also a floor arrival sensor at each floor in each elevator 
shaft to detect the arrival of an elevator. 

The elevator buttons, floor buttons, and floor arrival sensors are active asynchronous 
devices; that is, input firom these devices will automatically turn on their corresponding registers. The 
control software is responsible to poll these registers. The registers will automatically return to the off 
state once polled by the control software. The other I/O devices are all passive. The elevator and floor 
lamps, as well as the direction lamps are switched on and off by the software. 

Timing requirements: 

• Elevator buttons are pressed with a maximum frequency of 5 times per second, which represents a 
minimum inter-arrival time of200 msec. 

• Floor buttons are pressed with a maximum frequency of 2.5 times per second, which represents a 
minimum inter-arrival time of400 msec. 

Each elevator takes at least 2 seconds to open or close its door, 9 seconds to accelerate, 
travel and then decelerate to the next floor, and about ! second to travel one floor once the elevator 
attains its constant speed. The corresponding floor arrival sensor will be turned on when the elevator 
is halfway between the two floors. 

Table 1 ECS Requirements 
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tin(idle_Tjnier) 



Figure 26 ECS State Chart 

We have created 5 globally shared entries, as depicted in table 2, for processes to 


share information. These shared entries are: AStatusEniry, BStatusEntry, AscheduleEntry, 

BscheduleEntry and requestEntry. AstatusEntry entry and BstatusEntry entry stored the 

status of Elevator A and Elevator B respectively. For examples, push button states, 

elevator heading direction, door states and etc. XstatusEntry entry allows hardware 

emulator to update the control panel the status of the elevator when it transits from one 

state to another. Similarly, for AscheduleEntry entry and BscheduleEntry entry, they store 

the data (e.g. request floor) for the next schedule planned by the scheduler for Elevator A 

and Elevator B respectively. Hardware emulator read this entry to determine the next 
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floor to service. RequestEntry entries contain the floor requests submitted to the 
scheduler either from the Control Panel or the Floor Panel. Once the scheduler reads 


them, it will remove them from the repository. 



Figure 27 ECS processes 
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No I EntrxlD 


1 AstatusEntrv- 

2 BStatusEntry 


Entrv^Type 


HashEntry 



RequestEntry 


AScheduleEntry 

BScheduleEntrv 


Content 


String: eievatorlD 
; Boolean: button! 
Boolean: button2 
Boolean: buttons 
Boolean: button4 
Boolean: buttonS 
Boolean: buttonb 
Boolean: button? 
Boolean: buttons 
Boolean: button9 
Boolean: button 10 
Integer: direction 
Integer: Level 


String: eievatorlD 
Integer: requestLevel 
Integer: direction 


String: eievatorlD 
Integer: destination 
Integer: direction 
Integer: current 
Boolean: status 


Table 2 ECS Shared Entries 


HashEntry 


HashEntrv 


Remark 


A3 

T: Active F:None 
T: Active F:None 
T: Active FiNone 
T: Active F:None 
T: Active F:None 
T: Active F:None 
T: Active FiNone 
T: Active F:None 
T: Active F:None 
T: Active F:None 
0:None i:Up 2:Down 
1**'- 10* floor 


None, A,B 
l’"'-10* floor 
OrNone i;Up 2:Down 


A3 

- 10* floor 

0;None l;Up2:Down 
1*“ -10* floor 
0;Done hln-prosxess 




Elevator B 



[:| 





Figure 28A Elevator A & B Control Panel 



Figure 28B Floor Control Panel 
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1. Declare and initialize entry 

The following code snippets show how we declare the entries and initialize their 
values in different programming languages 


XstatusEntry (In Java language) 

//Declare an status Entry 

agent.createID(agent.TS_HASH, statusEntrylD); 

//Initialize value 

TSHash ts = (TSHash) agent.getTSObject( agent.TS_HASH, statusEntrylD); 
if(ts != null){ 

tS-setBoolean(”buttonl '\false); 
ts. setBoolean( "buttonZ" ,false); 
ts.setBoolean( "buttons" ,false); 
ts. setBoolean( "button4" ,false); 
ts.setBoolean( "buttons" ,false); 
ts.setBoolean("button6" ,false); 
ts.setBoolean("button7",false); 
ts.setBoolean( "buttons",false); 
ts. setBoolean( "button9",false); 
ts. setBoolean( "button 10",false); 
ts. setBoolean( "up" ,true); 
ts.setBoolean("down",false); 

ts.setInteger("leverM); // level: 1 to 10 floor 

ts.setFloat("door",(float)1.0); // Door open percentage : 0 to 100% 

} 

requestEntry (In visual basic language) 

‘Declare an status Entry 
agent.createID(TS_HASH,requestEntryID) 

‘Initialize value 

agent.getTSObject(TS_HASH, requestEntryID).setString("elevatorID",”A”) 
agent,getTSObject(TS_H ASH, requestEntry ID) .setlnteger( "requestLe vel", 1) 
agent.getTSObject(TS_HASH, requestEntryID).setInteger("direction",0) 


Xschedule (In C languague) 

//Declare an status Entry 
createID(TS^HASH, “scheduleEntrylD”); 

//Initialize value 

TSHASHSetString(“scheduleEntryID”, “elevatorID”,”A”); 
TSHASHSetInteger(“scheduleEntryID”, “destination”,!); 
TSHASHSetInteger(“scheduleEntryID”, “direction” ,0); 
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TSHASHSetInteger(“scheduleEntryID”, ‘‘current’M); 


2. Read and Write Entry 

The following code snippets show how we read entries and write entries to and 
from the repository respectively. 

XstatusEntry (In Java language) 

// Read status entry contents 

TSHash ts = (TSHash) agent.getTSObject(TS_HASH, statusEntrylD); 
if(ts.readIfExists()) { 

frame.butl .setState(ts.getBoolean("buttonl")); 

frame.but2.setState(ts.getBoolean( "button2")); 

frame.but3.setState(ts.getBoolean("button3")); 

frame.but4.setState(ts.getBoolean("button4")); 

frame.but5.setState(ts.getBoolean("button5")); 

frame.but6.setState(ts.getBoolean("button6”)); 

frame.but7.setState(ts.getBoolean( "button?")); 

frame.butS. setS tate(ts. getB oolean(" buttonS")); 

franie.but9 .sets tate(ts .getBoolean( "button9")); 

frame.butl0.setState(ts.getBooiean("buttonlO")); 

frame.up.setState(ts.getBoolean("up")); 

frame.down.setState(ts.getBoolean("down")); 

franie.level.setValue(ts.getInteger("lever’)); 

frame.door.setValue(ts.getFloat("door”)); 

} 

// Update status entiy contents 

TSHash ts = (TSHash) agent.getTSObject(TS_HASH, statusEntrylD); 

ts. setB oolean( "button 1",false); 

ts.setBoolean( "button2",false); 

ts.setBoolean("button3",false); 

ts.setBoolean("button4",false); 

ts. setBoolean(" buttons",false); 

ts.setBoolean("button6" ,false); 

ts. setB oolean( "button?",false); 

ts.setBoolean("button8",false); 

ts.setBoolean("button9",false); 

ts. setB oolean( "button 10" ,false); 

ts.setBoolean("up",true); 

ts.setBoolean("down",false); 

ts.setlnteger("level",l); // level: 1 to 10 floor 

ts.setFloat("door",(float) 1.0); // Door open percentage : 0 to 100% 

ts.updateO; 
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requestEntry (In visual basic language) 

‘ Read schedule entry contents 

if agent.getTSObject(TS_HASH, requestEntry ID) .readIfExists() then 

elevatorlD = agent.getTSObject(TS_HASH, requestEntryID).getString("elevatorID") 
level = agent.getTSObject(TS_HASH, requestEntrylD). getInteger("requestLever’) 
dir = agent.getTSObject(TS_HASH, requestEntryID).getInteger("direction’‘) 


endif 

‘Write a new request entry 

agent.getTSObject(TS_HASH, requestEntrylD).setString("elevatorID",”A”) 
agent.getTSObj ect(TS_HASH, requestEntrylD). setlnteger( "requestLevel’', 1) 
agent.getTSObj ect(TS_HASH, requestEntrylD) .setlnteger( "direction" ,0) 
agent.getTSObject(TS_HASH, requestEntryID).write() 


Xschedule (In C ianguague) 

// Read schedule entry contents 
if(TSHASHReadIfExist(“scheduleEntryID”)) 

{ 

TSHASHGetString(“scheduleEntryID”, “elevatorlD”, elevatorlD); 
destination = TSHASHSetInteger(“scheduleEntryID”, “destination”); 
direction = TSHASHSetInteger(“scheduleEntryID”, “direction”); 
current = TSHASHSetInteger(“scheduleEntryID”, “current”); 

} 

// Update schedule entry contents 
TSHASHSetString(“scheduleEntryID”, “elevatorlD”,”A”); 
TSHASHSetInteger(“scheduIeEntryID”, “destination”, 1); 
TSHASHSetInteger(“scheduleEntryID”, “direction”,0); 
TSHASHSetInteger(“scheduleEntryID”, “current”,!); 
TSHASErWrite(“scheduleEntryID”); 
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VI. DISCUSSION 


A. JAVA PROGRAMMING LANGUAGE 

We have chosen Java programming language instead of other languages to 
implement the framework. Using Java programming language, it allows our codes to 
remain portable between various computing platforms without worrying about the 
underlying architecture, data representation and operating system of the actual machine 
that they are running. Java’s rich sets of APIs and object-oriented nature simplify our 
design. We have reused many packages that come along with JDK (Java Development 
Toolkit) in our implementation and our designs are simple and easy to understand. 

Java programming language also offers another distinct advantage. It allows code 
besides data to travel across the network and run on a client machine avoiding the tedious 
process of system configuration. This is important especially for distributed applications 
because processes tend to execute on different computing platforms; maintaining and 
managing a uniform operating environment can be very difficult. 

We foresee Java programming language to replace many of the existing native 
programming languages in the future. The evolution of the Internet has changed how 
people view software. With more devices like hand phone, PDA (personal device 
assistance), game console, connecting to the network in each day, writing software using 
machine dependent languages to meet new requirements and expect it to run and support 
a wide variety of platform and hardware might no longer be possible in the future. 
Nevertheless, we still have to co-exist with the existing languages in the mean time. Thus 
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we have built wrappers, ActiveX wrapper and native C library wrapper, to allow other 
languages to access our agent as well. 

B. JINI TECHNOLOGY 

Jini Connection technology provides a simple mechanism for objects (clients or 
services) to discover, join and detach with one another. This makes it very attractive to us 
in terms of designing and managing processes running in a distributed environment. Our 
agent service can easily locate and replace services (such as JINI/transaction service) that 
its processes are using but have become unavailable because of system failure or network 
congestion, and processes can still find the agent service even if we change its network 
location. 

Another reason that has affected our decision is that many services such as 
JavaSpace service, transaction service, leasing service and etc are already available. It 
would have taken us a lot of efforts if we were to build similar functions from scratch. 
JavaSpace service has given us a Linda TupleSpace Model type of communication 
mechanism that we are looking for our loosely coupled processes. Although there are 
similar implementations like IBM Tspace Cloudscape’s Java database, which are also 
written in Java programming language, we preferred JavaSpace because of its scalability. 
We could create new services to supplement any features that it does not have. 

C. FUTURE WORKS 

Our current implementation is only the first step towards fulfilling our agent 
framework. We have focused more on designing and building an architecture that is 
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scalable and robust. Although we have addressed many of the difficult issues caused by 
the distributed environment, solved the problems of inter-processes communications and 
managed a dynamic network, there are still many other areas in our framework where 
improvements can be made on. Some of them are listed as below. 

Enhance Agent Service - The features provided by our agent service are currently 
quite limited. It only provides simple authentication and coordination mechanism for 
controlling process using its service. Other features that can be added are 

□ Provide an GUI to manage and monitor processes mnning in the network 

□ Provide connection to backend server like email, database, rule-base 
engine and etc 

Point-to-Point Communication Service — The Linda TupleSpace type of 
communication is a great way of sharing information in a distributed environment if there 
is no strict constraint on response latency. From the experiments that we have carried out 
every entry operation, e.g. read an entry from repository, carried a latency penalty of 
eight milliseconds compare to less than a millisecond for point-to-point communication 
using sockets. Point-to-Point communication is also more suitable for sending large 
amounts of data between two processes. 

Security Issues - Security is one of the areas we did not spend much time on. One 
of the reasons is that we are waiting for the JINI Connnunity to finish their design on 
how they are going to incorporate the security mechanism into their infrastructure. 
Security will be a very important issue if processes are connected to the Internet. 
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VII. CONCLUSION 

This thesis presented a simple agent-based framework to address the concerns for 
building distributed applications. Agents act as the interfaces for processes to interact 
and to cooperate in a distributed heterogeneous environment. It shields developers from 
the underlying dynamic and complex network environment by encapsulating the 
implementation details in the agents and providing a simple set of Application Program 
Interfaces (API), where processes writing in variety of programming languages that can 
be easily invoked. The thesis discussed in detail the characteristics of the software agents 
including agent service, agent operations, agent attributes, and agent language wrappers. 
Software agents provide a wide range of primitive data types, as well as the feasibility of 
user-defined formats. Concerns in a distributed environment, such as partial failure, 
synchronization and coordination, have been taken into consideration in the proposed 
agent framework through various agent operations. The agent attributes, by 
communication leasing time, time-out and transaction, explore the possibility of 
providing time constraints for distributed system communications over the network. It 
enriches the research of distributed system prototyping. The language wrapper concept 
makes the proposed framework feasible in most of language platforms, which achieves 
the interoperability among heterogeneous software components. Test-bed applications 
and the example demonstrate the important features and show the feasibility of the 
proposed technology and methodology. 

The framework is built on JINI infrastructure to simplify the tasks of building and 
maintaining reliable distributed systems. It uses a Linda TupleSpace model, a shared 
network-accessible repository, for different processes to exchange information. 
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Processes are loosely coupled. They discover and linkup with one another by using 
services residing on JINI infrastructure. Based on the JINI structure, the agent service 
provides an interface of developing other features in building a distributed system such as 
security management. 

This framework is to be used in the Distributed Computer Aided Prototyping 
System (DCAPS) [LUQI92] to provide the inter-process communication layer. The agent 
framework provides the glue library in the wrapper/glue architecture for distributed 
system prototyping. It simplifies the tasks of designing, binding and analyzing multiple 
processes of real-time, distributed systems. Introducing time constraints for network 
communications into the distributed system design is an initial effort in the research of 
distributed system prototyping. 




[CLOUDOO] 

LIST OF REFERENCES 

Cloudscape. Cloudscape Java database. httD://www.cloudscaDe.com 

[DCOM96] 

Microsoft Corporation, DCOM Technical Overview, Nov. 1996. 
http;//msdn.microsoft.coin/librarv/back 2 md/html/msdn dcomtec.htm 

[GEL85] 

D.Gelemter, Generative Communication in Linda, ACM Trans. 
Programming Languages and Systems, 7(1), Jan. 1985, pp. 80-112 

[JOY99] 

Bill Joy, The Jini Specifications, Addison Wesley, Inc., 1999 

[JVM96] 

Lindhom, T. and Yellin, F., The Java Virtual Machine Specification, 
Addison-Wesley, ISBN 0-201-63451-1 

[JS99] 

E. Freeman, S. Hupfer and K. Arnold, JavaSpaces: Principles, Patterns, 
and Practice, Addison-Wesley, 1999 

[LUQI92] 

Luqi, ""Computer-aided prototyping for comand and control system using 
CAPS’\ IEEE Software, 9(1), Jan. 1992, pp 56-67 

[KEI99] 

Edward Keith, Core Jini, Prentice, Gall PTR, 1999 

[MEESON97] 

Reginald N. Meeson, Analysis of Secure Wrapping Technologies 
(Alexandria, VA; Institute for Defense Analysis). 

[ORB91] 

The Object Management Group, Common Object Request Broker: 
Architecture and Specification, OMG Document Number 91.12.1(1991) 

[ROBERT98] 

Robert Holton, Real Time Systems, 

http://www.comD.brad.ac.uk/home/comDutine/Modules/CM0506D/Cour 


seware/weekl 1/nodel .html 

[RMIOO] 

Sun Microsystems, Remote Method Invocation. Java 2 SDK 
Documentation. Dec 2000. http://iava.sun.eom/Droducts/idk/l.2/docs 

[TSPACESOO] 

IBM. Tspaces. http://www.almaden.ibm.com/cs/TSDaces 


69 



TfflS PAGE INTENTIONALLY LEFT BLANK 


70 



APPENDIX A. AGENT API 


Package 


Ciass 


Tree Index Help 


PREV CLASS NEXT CLASS 

SUMMARY: INNER ! FIELD | CONSTR j METriOD 


FRAMES NO FRAMES 

DETAiL: FIELD I CONSTR ! METHOD 


TUPLESPACE.CORE 

CLASS AGENT 


Java.Iang.Object 


•F-tu piespace.core. Agent 


public class Agent 
extends java.lang.Object 

implements java.io.Serializable, tuplespace.entries.SpaceActionHandler, TSConstants 
The Agent class implements the methods to configure agent properties, establish 
connection with Jini Services, request for transaction and create new entry handlers 
See Also: 

Serialized Form 


Constmctor Summary 

l Agent O 


} Agent(java.iang.String propertiesFiiename) 


;Method Siumnary J 

boolean 

abortTransactionO 

Abort the current transaction; all the commands issued with this 
transaction after the start transaction will be rolled back. 

void 

actioaPerfonned(iava.awt.event.ActionEvent e) 

. 1 

void; 

i 

addActioiiListenerfiava.awt.eventActionListener 1) 

1 

1 boolean! 

cleanTSClassdnt tvpe. iava.Iang.String id) 

Creates a new TSString ID 
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j boolean 

closeTransactionO 

closes the current transaction; all the commands issued with 
j transaction after the start transaction will become active. 

boolean 

; ! 

createlDfint tvoe. iava.lana.Strina idi i 

Create a new entry in agent | 

void 

ifireActionfint entrvTvoe. iava.lana.Strina entrvID'l 1 

t 

i tuplespace.entries.Spac 

1 eActionHandier 

" . . 

i 

aetActionHandlerf ) 

Return the spaceAction handle 

■< java.Iang.String 

£et.4sentLooku0Grou0n 

Return Agent Lookup Group 

1 java.Iang.String 

1 

aeL4aentLookuoURL0 

Return Agent Lookup URL 

1 java.Iang.String 

2et42entSecuritvPolicvf) 

Return Agent Security Policy path and filename 

java.Iang.String 

setAacntServerCodebasef) 

Return Agent Server Codebase 

i java.Iang.String 

i 

setAgentSpaceNameO 

Return Agent Space Name 

1 tuplespace.core.Transac i 

i tionj 

1 i 

setTransactionfl 1 

Return the transaction handle; transaction manager must be 
initialized and started 

j java.Iang.String 

1 ; 

1 

eetTSClassIDstint tvoet 

Return all TSString IDs created 

java.Iang.Object 

setTSObiectiint tvoe. iava.lana.Strina idl 

Remove an existing TSString ID 

i 

setTSTvoefiava.Iana.Strina tvoet 

1 boolean 

1 

InitAeentfiona timeout! 

Look for the Jini Services and test whether the interface is 
functioning 

boolean^ 

] \ 

isTransactionStartedf) 

Return the current state of transaction handle 

j void 

Drmt(iava.lana.Strina str! 
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1 

i 

void 

1 

readA2entProD€rties(i3vaJanq.String filename) 1 

void 

removeActionListenerfiava-awtevent-ActionListenerl) 

1 i 

boolean ; 

removeID(int type, iava.Iang.String id) 1 

Remove an existing TSString ID | 

i void 

SearchTSCIassIDsft 

void 

setAgentLookuoGroupfiava.Iang.String str) 

Set Agent Lookup Group 

void 

setAgentLookuoURLfiava.Ianq.String str) 

Set Agent Lookup URL 

■ void 

< 

1 

I 

setAgentSecuritvPolicvCiavaJanq.Strinq str) 

Set Agent Security Policy path and filename 

1 void 

! 1 

setAgentServerCodebaseliava.iang.Stringstr) 

Set Agent Server Codebase 

1 void 1 

i ^ 

setAsentSoaceNamefiavaJanq.Strina str) 

Set Agent Space Name 

( boolean 

startTransacdonf) 

Start transaction manager; transaction handle will remain valid 
for a maximum of 5 minutes (Default setting) 

? i 

j void 

1 

1 ■ 

TerminateAcentO 

i boolean 

1 

1 

1 uudateTrausactionHandlefint tvpe. iava.Iang.String id) 

1 Update the transaction handle in TSObject 
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Package 


Class 


Tree 


PREV CLASS NEXT CLASS 

SUMMARY: INNER I FIELD I CONSTR I METHOD 


index Help 

FRAMES NO FRAMES 
DETAIL: FIELD I CONSTR i METHOD 


TUPLESPACE.CORE 

CLASS SERVICEFINDER 

tuplespace.cofB.ServiceFinder 
public class ServiceFinder 

A LookupFinder implements the methods needed locate a service in a Jini(tm) Lookup 
service. 


Constructor Summary 

ServiceFinder^ 

Create a new LookupFinder object 


... — „ , ..... 

M 1 

java.Iang.Object 

! 

indfcom.sun.iini.mahout.LocatOT locator, java.Iang.String name) 

Using the Jini lookup service returned by locator find the 
service registered with a net.jini.lookup.entry.Name attribute who’s 
[value is name. 


I 
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Package 


Class 


PREV CLASS NEXT CLASS 
SUMMARY; INNER t FIELD 1 CONSTR I METHOD 


index Help 

FRAMES NO FRAMES 
DETAIL: FIELD | CONSTR ] METHOD 


TUPLESPACE.CORE 

CLASS SERVICEACCESSOR 

java.Iang.Object 


+—tuplespace.core.ServiceAccessor 


public class ServiceAccessor 
extends javaJang.Object 
implements java.io.Serializable 

The ServiceAccessor class implements the methods for registering the Services 

See Also: 

Serialized Form 


Constractor Summary 


ServiceAccessorO 



^lethod Summm*y 


static com.sun.jini.mahout.Locator: 

• 

getLocatornonq lookupTimeout) 

static netjint.core-transaction.serven | 
TransactionManager i 

getManaserO 

( static net.jini.core.transaction.server. j 

i TransactionManager| 

getManaHerfiava.lana.Strinp name) 

r"'"' ~1 

i static net.jini.space.JavaSpace j 

I : 

getSoacef) 

\ static net.jini.space.JavaSpace 

i 

\ getSpacefiava.Iana.String name) 

1 

1 
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Package 


Class 


Tree 


PREV CLASS NEXT CLASS 
SUMMARY; INNER \ FIELD | CONSTR j METHOD 


Index Help 

FRAMES NO FRAMES 

DETAIL; FIELD i CONSTR I METHOD 


TUPLESPACE.CORE 

INTERFACE SPACEEVENTREGISTRATION 

All Known Implementing Classes: 

TSBooIean . TSClass, TSDouble. TSFIoat . TSHash . TSInteser . TSLong . TSOueue . 
TSString 


public abstract interface SpaceEventRegistration 

The SpaceEventRegistration class implements the methods for for registering with Space 
Service to monitor new entries written into the space. 


f;;. ■■ j' 

odSmnmary ^ ^ ^ ^ 

boolean 

startEventf) 

boolean 

startEventlftuDlesoace.entries.SDaceActionHandlerspaceAction'l 

boolean 

i 

startEvent2{tUDleSDace.entries.SDaceActionHandler soaceAction. Iona leased 

j boolean 

startEventSttuDlesDace.entries.SoaceActionHandler spaceAction. Iona lease. 
tuplespace.core.Transaction txn) 

j boolean 

1 1 

stODEvent() 

1 








Package 


Class 


Tree Index 


Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY; INNER [ FIELD | CONSTR1 METHOD DETAIL: FIELD 1 CONSTR ] METHOD 


TUPLESPACE.CORE 

INTERFACE SPACELISTENER 


public abstract interface SpaceListener 
extends java.awt.event.ActionListener 


Method Summary 

void 

actionPerfonned{iava.awt.event.ActionEvent e) 

void 

i \ 

fireActionO 
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Package 


Class 


PREV CLASS NEXT CLASS 
SUMMARY: INNER i FIELD \ CONSTR | METHOD 


Index Help 

FRAMES NO FRAMES 

DETAIL: FIELD i CONSTR | METHOD 


TUPLESPACE.CORE 
INTERFACE TSCONSTANTS 

All Known Implementing Classes: 

Agent , TSCIass. TSDouble. TSFIoat. TSHash. TSInteger . TSLong. TSOueue . 
TSBooIean . TSString 


public abstract interface TSConstants 


Field Summary 

static int 

txS BOOLEAN 

static int 

TS DOUBLE 

static int 

TS FLOAT 

static int 

TS HASH 

static int 

j 

TS INTEGER 

.-. -.-. r . ■■ .-., .. 

static int 

TS LINKLIST 1 

static int ^ 

TS LONG j 

! Static int; 

TS OLTiUE i 

-.-. . 1 

1 static int; 

TS STACK f 

1 

' 1 

static int i 

i j 

TS STRING ! 

: ! 
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Package 


Class 


PREV CLASS NEXT CLASS 

SUMMARY: INNER i FIELD I CONSTR [ METHOD 


Index Help 

FRAMES NO FRAMES 

DETAIL: FIELD j CONSTB 1 METHOD 


TUPLESPACE.CORE 

CLASS TSBASE 


java.iang.Object 


+-tuplespace.core.TSBase 
Direct Known Subclasses: 

TSBoolean, TSClass, TSDouble , TSFloat, TSHash, TSIntegen TSLong . 
TSOueue, TSString 


public class TSBase 
extends javaJang.Object 
implements java.io.Serializable 

The TSBase class implements the methods for setting the attribute of entry. Every entry 
handler will inherit this class 
See Also: 

Serialized Form 


J Constnictor Siimiimiy y ^ 

f"'.... — .'.'.. ■".... 

i TSBaseO 


{Method Summary 


long 

setReadTimeOutO 

get read time out 

---- 

boolean 

setResultCl 

j long 

setTakeTimeOutO 


get take time out 

i tuplespace.core. 

getTransactionHandlerO 

Transaction 
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O) 

c 

o 

setUpdateLeaseTImef) 

get update lease time 

long 

getWriteLeaseTimeO 

get write lease time 

void 

j 

initTSBaseCnet.iini.SDace.JavaSDace soace. i 

tuplespace.entries.SpaceActionHandler spaceAction, java.iang.String entrylD) | 

____..._._. 1 

protected void 

printfiava.Iana.Strina strt 1 

For debugging purposes j 

void 

setIavaSDace(net.iini.sDaceJavaSDace soacei 1 

set space ! 

void 

setReadTimeOutdona timeOutl * 

set read time out 

void 

1 

setResultfboolean valuel 

I void 

setSpaccActionHandlerftuDlesDace.entries.SDaceActionHandler spaceActioni 

i 

set action listener 

< 

o 

a 

i sctTakeTimeOutflona timeOut) 
set take time out 

void 

1 

setT ransactlonHand!er(tUD!esDace.core.T ransaction transi 

set action listener 

void 

i 

setUpdateLeaseTimedona leaseTimel 
set update lease time 

void 

( 

setWriteLeaseTimedona leaseTimel i 

set write lease time j 
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Package 


Class 


PREV CLASS NEXT CLASS 

SUMMARY: INNER i FIELD i CONSTR ! METHOD 


Index Help 

FRAMES NO FRAMES 

DETAIL; FIELD I CONSTR I METHOD 


TUPLESPACE.CORE 

CLASS TSBOOLEAN 

java.lang.Object 


■F-tuplespace.core.TSBase 


+—tup!espace.core.TSBoolean 


public class TSBooIean 
extends TSBase 

implements java.io.Serializable, SoaceEventRegi stration , TSConstants 
The TSBooIean class implements the methods for reading, writing, updating, notifying 
and retrieving EntryBoolean entry from space. Every EntryBoolean entry in the space is 
identified by an unique ID (entrylD). A subclass that implements the 
SpaceActionHandler interface has to load during initialization if remote event notification 
is used. 

See Also: 

EntryBoolean, Serialized Form 

jFields inherited from cl ass tupiespace,core,TSBase 

I entrvID . eventRegistration. notifVLeaseTime. readTimeOut . result , space . spaceAction . takeTimeOut . 

I transaction, uDdateLeaseTime, writeLeaseTime 

Constractor Siunnaary 

j TSBoolean fnet.i!ni.space.JavaSpace space, 

i tupiespace.entries.SpaceActionHandler spaceAction, java.Iang.String entrylD) ! 

Constructor for TSBooIean 


Method Summary 


i T— — 

void! cleanSpaceO 

J j Remove all existing entries from space 
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void 

cleanSDacelftuDlesDace.core.Transaction txn) 

Remove all existing entries from space 

boolean 

initTSBooleantnet.iini.sDace.JavaSDace space. 

tup!espace.entries.SpaceActionHandier spaceAction, java.Iang.String entrylD) 
initialize TSBoolean 

.. .. i 

boolean 

readIfExistsO | 

Reads an entry value j 

boolean 

readlfExistsKlona timeOutl ! 

Reads an entry value j 

boolean 

i 

readIfExists2fiona timeOut. tuolesoace.core.Transaction txn^ 1 

Reads an entry value | 

boolean 

startEventO 

Start notificiation; remote event will be raised if any entry that 
matches the entry ID is added into the space. 

boolean 

startEventlftuDlesoace.entries.SDaceActionHandler spaceAction'i 

Start notificiation; remote event will be raised if any entry that 
matches the entry ID is added into the space. 

j boolean: 

j 

startEventZftuDleSDace.entries.SoaceActionHandler spaceAction. long leased 
Start notificiation; remote event will be raised if any entry that 
matches the entry ID is added into the space. 

i boolean i 

1 

startEventSftuDleSDace.entries.SDaceActionHandler spaceAction. long lease 
tuplespace.core.Transaction txn) 

Start notificiation; remote event will be raised if any entry that 
matches the entry ID is added into the space. 

j boolean 

i 

I stooEventri 

Stop notification 

j boolean 

takelfExistsO 

Takes an entry value; entry will be removed from space 

i boolean 

takelfExistsKlona timeOutl 

Takes an entry value; entry will be removed from space 

* boolean 

i takeIfExists2nona timeOut tUDlesnace.core.T ransaction txn^ 

Takes an entry value; entry will be removed from space 

i boolean 

1 

i 

transReaddona timeOutl 

Reads an entry value with transaction 
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boolean 

i 

transTakedona timeOut) 

Takes an entry value with transaction; entry will be removed from 

space 

< 

boolean 

1 

..^ 

transUpdatefbooiean value, long lease) I 

Updates an existing entry value with transaction ! 

boolean 

1 

j 

1 

transWritefboolean value, long lease) j 

Writes entry value with transaction } 

boolean 

uodateKboolean value) ! 

Updates an existing entry value j 

boolean | 

: 1 

uDdate2{boolean value. long lease) j 

Updates an existing entry value 1 

f....... 

boolean 

uodateStboolean value, long lease, tupiespace.core.Transaction txn) j 
Updates an existing entry value ] 

i-i 

boolean j 

writel (boolean value) 

Writes value to space 

boolean : 

write2(booiean value, long lease) 

Writes value to space 

boolean : 

writeSfboolean value, long lease, tupiespace.core.Transaction txn) 
Writes value to space 
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Package 


Class 


Tree 


PREV CLASS NEXT CLASS 

SUMMARY; INNER I FIELD I CONSTR i METHOD 


Index Help 

FRAMES NO FRAMES 

DETAIL: FIELD I CONSTR I METHOD 


TUPLESPACE.CORE 

CLASS TSDOUBLE 

java.Iang.Object 

■^-tuplespace.core.TSBase 


+“tuplespace.core.TSDouble 


public class TSDouble 
extends TSBase 

implements java.io.Serializable, SnaceEventRegistration . TSConstants 
The TSDouble class implements the methods for reading, writing, updating, notifying and 
retrieving EntryDouble entry from space. Every EntryDouble entry in the space is 
identified by a unique ID (entrylD), A subclass that implements the SpaceActionHandler 
interface has to load during initialization if remote event notification is used. 

See Also: 

EntryDouble, Serialized Form 


Fields inherited from class tupIespace.core .TSBase 

j .*... . .-.... ....I.. . . . .......- 

l entrvID . everrtRegistration. notifvLeaseTime. readTimeOut. result, space. spaceAction. takeTimeOut . 
; transaction . updateLeaseTime . writeLeaseTime 

f —--r 


Constructor Sumiriaiy 

i TSDoubtet netiini.soace.JavaSpace space, 

i 

jtuplespace.entries.SpaceActionHandler spaceAction, java.lang.String entrylD) 
Constructor for TSDouble 


Method Summary 

void 

cleanSpaceO 1 


Remove all existing entries from space j 

■ void 

cleanSpacel ftuolesoace.core.T ransaction txnt ! 

..........—...... - .. i 
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r~- 

; 

. i 

Remove all existing entries from space j 

; 

boolean 

• 

j 

initTSDoublefnetiini.spaceJavaSpace space, 1 

tuplespace.entries.SpaceActionHandler spaceAction, java.Iang.String entrylD) | 
initialize TSDouble | 

double ; 

readIfExistsO 1 

Reads an entry value j 

: 

double 

readlfEjdstslflona timeOut) 1 

Reads an entry value | 

1 

double 

readIfExists2(long timeOut, tuplespace.core.Transaction txn) | 

Reads an entry value 

boolean 

startEventO 

Start notificiation; remote event will be raised if any entry that 
matches the entry ED is added into the space. 

r-*—^... 

boolean 

startEventKtuplespace.entries.SpaceActionHandler spaceAction) 

Start notificiation; remote event will be raised if any entry that 
matches the entry ID is added into the space. 

... ... 

boolean 

startEventZltuplespace.entries.SpaceActionHandler spaceAction, long lease) 

Start notificiation; remote event will be raised if any entry that 
matches the entry ED is added into the space. | 

? boolean 

1 

i 

j 

lstartEvent3(tuplespace.entries.SpaceActionHandler spaceAction, long lease, ! 

tuplespace.core.T ransaction txn) t 

j Start notificiation; remote event will be raised if any entry that 

[ matches the entry ED is added into the space. 

t ' 

boolean 

^ ! 

stooEventf) 

Stop notification 

i double i 

! 1 

takelfExistsO i 

Takes an entry value; entry will be removed from space | 

; double ! 

^ i 

i i 

takelfExistslflona timeOut) 

Takes an entry value; entry will be removed from space 

t .. 

j double i 

1 

takeIfExists2(iona timeOut, tuplespace.core.Transaction txn) i 

Takes an entry value; entry will be removed from space 1 

j double 1 

transReadflona timeOut) 

Reads an entry value with transaction 

j double 

transTakedong timeOut) 

Takes an entrv value with transaction: entrv will be removed from 
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Space 

boolean 

transUDdatefdouble value. Iona leased 

Updates an existing entry value vi?ith transaction 

boolean 

transWritefdouble value, lono lease! 

Writes entry value with transaction 

boolean 

apdateKdouble value! 

Updates an existing entry value 

boolean 

i 

i 

uDdate2(double value. Iona lease! 

Updates an existing entry value 

; boolean 

i 

iipdateSldouble value, Iona lease. tuplespace.core.Transactiontxn! 

Updates an existing entry value 

boolean 

swritel (double value! 

Writes value to space 

i boolean 

I 

write2(double value. Iona lease! 

Writes value to space 

boolean 

i 

writeSfdouble value. Iona lease. tuplespace.core.Transaction txn! 

Writes value to space 


i 
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Package 


Class 


Tree 


PREV CLASS NEXT CLASS 

SUMMARY: INNER I FIELD I CONSTR I METHOD 


Index Help 

FRAMES NO FRAMES 

DETAIL: FIELD i CONSTR f METHOD 


TUPLESPACE.CORE 
CLASS TSHASH 


java.Iang.Object 


■» —tupiespace.core.TSBase 


+“tup!espace.core.TSHash 


public class TSHash 
extends TSBase 

implements java.io.SeriaIizable, SpaceEventRegistration, TSConstants 
The TSHash class implements the methods for reading, writing, updating, notifying and 
retrieving EntryHash entry from space. Every EntryHash entry in the space is identified 
by an unique ID (entrylD). A subclass that implements the SpaceActionHandler interface 
has to load during initialization if remote event notification is used. 

See Also: 

EntryHash, Serialized Form 
i Fields teierited from class tu^ 

• entrvID . eventRegistration. notifvLeaseTime . readTimeOut . result , space , space Action. takeTimeOut, 

I 

(transaction, updateLeaseTime . witeLeaseTime 

: CoBstmctorSmxxinary \ 

j TSHash (net jini.space.JavaSpace space, tuplespace.enbies.SpaceActionHand!er spaceAction, 
ijava.iartg.String entrylD) 
j Constructor for TSHash 


Method Siumnary ;■ 

void 

cleanSoaceO 

Remove all existing entries from space 

void 

1 cleanSDacelftupiespace.core.Transaction txn) 
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Remove all existing entries from space j 

boolean 

1 clearContainerf) i 

\ i 

boolean 

setBoolean^iava.iana.Strina idi 

i : 

i i 

java.utii.HashMap 

^ aetContainerri ! 

s 1 

i 

void 

iaetContainerfiava.util.HashMap map! 1 

i 1 

{ double 

i 

aetDouble(iava.!ana.Strina idi i 

1 

float 

aetFloatHava.Iana.Strina idl 1 

_i 

int 

aetlnteaeriiava.lana.Strino id> 

tong 

aetLona(iava.!ana.Strina idi 

1 

: java.lang.String i 

i 1 

t ] 

aetStrinatiava.Iana.Strina idl 

c 

(0 

Q> 

1 

initTSHashfnetJini.SDaceJavaSpace space. 
tuplespace.entries.SpaceActionHandler spaceAction, 
java.lang.String entrylD) 
initialize TSHash 

boolean; 

■ 

; 

readIfExistsfi 

Read entry value 

boolean 

: 

readlfEsastslflona timeOuti 

Read entry value 

boolean 

readIfExists2(long timeOut. tupiespace.core.Transaction txni 1 

Read entry value 1 

boolean | 

removenava.Iana.Strina idi 

boolean 

setBooleandava.Iana.Strina id. boolean value'i ! 
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boolean 

setDoub!e(iava.lanq.Strinq id, double value) ! 

j 

boolean 

setFloat{fava.lanq.Strina id, float value) 1 

1 

1 

boolean 

1 

setInteser(iavaJana.Strinq id, int value) 1 

[ 

boolean 

setLongCiava.Ianq.Strinq id, lonq value) 1 

boolean 

setStrinsdava.Ianq.Strinq id, iava.Ianq.Strinq content) 

boolean 

startEventO 

Start notificiation; remote event will be raised if any 
entry tiiat matches the entry ID is added into the space. 

boolean 

! i 

startEventKtuDlesDace.entries.SDaceActionHandlerspaceAction) 

Start notificiation; remote event will be raised if any 
entry that matches the entry ID is added into the space. 

boolean 

1 

] 

j 

startEvent2(tuDiesDace.entries.SpaceActionHandlerspaceAction, 

long lease) 

Start notificiation; remote event will be raised if any 
entry that matches the entry ID is added into the space. 

j boolean j 

! 1 

! 1 

1 1 

startEvent3ftuoiesDace.entries.SpaceActionHandlerspaceAcflon, 

long lease, tupiespace.core.Transaction txn) 

Start notificiation; remote event will be raised if any 
entry that matches the entry ID is added into the space. 

1 boolean j 

i 

stooEventO 

Stop notification | 

i-— 

j boolean 

takelfExistsO j 

1 

Take entry value; entry will be removed from space 

1 boolean i 

i i 

? ; 

takelfExistslHonq timeOut) 

Take entry value; entry will be removed from space 

?.-.... ; 

boolean 

i i 

1 

takeIfEkists2(iona timeOut. tupiespace.core.Transaction txn) 

Take entry value; entry will be removed from space 

i 

1 boolean 

transReaddonq timeOut) 

Reads an entry value with transaction 
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boolean 

transTakeflono timeOuO ! 

Takes an entry value with transaction; entry will be 1 

removed from space 1 

boolean 

transUodateflono leasel i 

Updates an existing entry value with transaction | 

boolean 

transWritedono ieasei ’ 

Writes entry value with transaction 

boolean 

updated ! 

updates an existing entry value 1 

boolean 

uodateldono lease) ! 

Updates an existing entry value | 

; boolean 

uodate2(lona lease. tUDlesoace.ajre.Transaction txn) 

Updates an existing entry value 

^ boolean 

i 

3 

write{) 

Writes value to space 

j boolean 

t 

•writelfiona lease) 

Writes value to space 

boolean 

write2flona lease. tuDiesoace.core.Transaction txn) 

Writes value to space 
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APPENDIX JINl/SERVICES SETOP 





pe 



j:T 

»paiiage 

f AgaitSenace • 




Jgsra Command: 

' "' ! 1 i 

java 1- 

. 

■ 

. Java Options: 

’ 

-cp 1 

Setup ■ JVfJ Options ■: 

J\lib\jini-core.jar;b:Uin!l_l\lib\jirii-exLiar;h;Uinil_1\libtsun-util.jar;}t:\:; 

, Secufftif Poficj? File ;■ 

-Djava.security.po!icv=h:'yini1_1\po!iciApo!icy.ali 

. Codsbase: 

-Diava.rmi.server,cociebase=http;//MELPOMENE;8081/ 

Executalrte ri 

tuplespace.servicesAgentService 

i---rrr-rr-...■ ...—-r- ^ 


#StarcService 

Sep 18 17:00:03 SDT 2000 


service.list=RKID \ 

Webserver \ 

LookupService 
LookupBrowser \ 

TxnManager \ 
JavaSpace \ 

AgencService 


\ 


# RMID 

# 

R^!ID.labell=RMID Cornmand : 

RKID. IajDel2=:Options : 

RMID. opt ionl=r 2 :\id 

HKID. option2=~J~Dsun. nrd. activation. exec ?olicy\-none 


# Webserver 

Webserver.labe11=Java Command : 

Webserver.Iabel2=Java Options : 

Webserver.label3^Executable Jar File : 
Webserver.label4=Fort : 

WebServe r.X abe15=Document Area : 

VJebServer. label 6=Log Downloads : 

Webserver.optionl=j ava 
Webserver.option2=~ j ar 

Webserver.option3 ^d:\\jini1_1\\Xib\\tools.j ar 
Webserver- optlon4=-port SOSI 
Webserver.option5=-dir d:\\jiniX_l\\lib 
Webserver.option6= 
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# 

# Reggie - Lookup Service 

# 

LookupService.label1=Java Command : 

LookupService.label2=Java Options : 

LookupService,label3=Setup JVM Options : 

LookupService.label4=Executable Jar File : 

LookupSeirvice. label5=Codebase : 

LookupService.label6=Security Policy File : 

LookupService.label7=Log Directory : 

LookupService.label8=Groups : 

LookupService.label9=Server JVM : 

LookupService.labellO=Server JVM Arguments : 

LookupService.optionl=java 
LookupService.option2 = ~ j ar 

LookupService.option3 = -Dj ava.security.policy=d:\\jinil_l\\policy\\policy.all 

LookupService.option4=d:\\jini1_1\\lib\\reggie.j ar 

LookupService.option5=http://tiptop:8081/reggie-dl.j ar 

LookupService.option6=d:Wjinil_l\\policy\\policy.all 

LookupService.option7=\\tmp\\reggie_log 

LookupService.option8=public 

LookupService.option9= 

LookupService.optionl0= 

# 

# LooJcup Browser 

# 

LookupBrowser.label1=Java Command ; 

LookupBrowser.label2=Java Options : 

LookupBrowser.label3=Jar File : 

LookupBrowser.label4=Security Policy File : 

LookupBrowser.label5=Codebase : 

LookupBrowser.label6=Lookup Browser : 

LookupBrowser.label7=Admin Mode : 

LookupBrowser.label8=Groups : 

LookupBrowser.optionl=java 
LookupBrowser.option2=-cp 

LookupBrowser .options=d: \\jinil_l\\lib\\j ini-examples .jar 

LookupBrowser.option4=-Dj ava.security.policy\=d:\\jinil_l\\example\\browser\\policy 
LookupBrowser. option5=-Dj ava. rmi . server. codebase\=http: / / tiptop: 8081 / j ini-exaiiples-dl. j ar 
LookupBrowser. option6=com. sun. j ini . example .browser. Browser 
LookupBrowser. opt ion7= 

LookupBrowser. option8= 

# 

# Mahalo - TxnManager 

# 

TxnManager.label1=Java Command : 

TxnManager.label2=Java Options : 

TxnManager.labels=Setup JVM Options : 

TxnManager.label4=Executable Jar File : 

TxnManager.label5=Codebase : 

TxnManager.label6=Security Policy File : 

TxnManager.label7=Log Directory : 

TxnManager.label8=Groups and Locators : 

TxnManager. label9=Se3rver JVM : 

TxnManager,label10=Server JVM Arguments : 

TxnManager.optionl=java 
TxnManager.option2=-j ar 
TxnManager.option3= 

TxnManager. opt ion4=d: \ \ j ini 1_1 \ \ 1 ib\ \mahalo. j ar 
TxnManager.optionS^http://tiptop:8081/mahalo-dl.j ar 
TxnManager.option6=d:\\jinil_l\\policy\\policy.all 
TxnManage r.option7=d:\\tmp \\maha1o_log 
TxnManage r.option8=public 
TxnManager.option9= 
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TxnManager.optionlO= 

# 

# JavaSpace 

# 

JavaSpace.optionl=java 
JavaSpace.option2 = -j ar 

JavaSpace.option3=-Djava.security.policy\=d:\\jiiiil_l\\policy\\policy.all 

JavaSpace.option4=:-Djava.rmi. server. cod.ebase\=http: //tiptop: 8081/outrigger-dl. jar 

JavaSpace. opt ion5=-Doom. sun. j ini .outrigger. spaceNanne=JavaSpaces 

JavaSpace.option6=d:\\jinil_l\\lib\\transient-outrigger.j ar 

JavaSpace.option7=public 

JavaSpace.option8= 

JavaSpace.labell=Java Command : 

JavaSpace.Iabel2=Java Options : 

JavaSpace.label3=Java Security File : 

JavaSpace.label4=Codebase : 

JavaSpace.label5=JavaSpace Name : 

JavaSpace.label6=Executable Jar File : 

JavaSpace.label7=Groups : 

JavaSpace.label8=Locators : 


# 

# Agent Service 

# 

AgentService.label1=Java Command ; 

AgentService.label2=Java Options : 

AgentService.label3=Setup JVM Options : 

AgentService.labe14=Security Policy File : 

AgentService.label5=Codebase : 

AgentService.label6=Executable : 

AgentService.optionl=j ava 
AgentService.option2=-cp 

Agent Service.option3 =D:\\Jini1_1\\1ib\\jini-core.j ar;D:\\Jini1_1\\1ib\ \jini - 
ext.jar;D:\\Jinil_l\\lib\\sun-util.jar;d:W 

AgentService.option4=-Dj ava.security.policy=d:\\jinil_l\\policy\\policy.all 
#AgentService.option4=-Djava.rmi.seiver.codebase=http://tiptop:8081/ 
AgentService.option5=-Dj ava.rmi.server.codebase=http://tiptop:8081/ 
AgentService.option6=tuplespace.services.AgentService 

# 

# END 

# 
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APPENDIX C. AGENT TEST BENCH LISTING 

A. JAVA VERSION 



1. JavaT^tBench-java 

package tuplespace.core; 
inport java.awt-*; 
irrpor t j ava. awt. event:. *; 
irr^rt java.appier. *; 
ixnport j avax. swing. *; 
import java.util.Vector; 
iirport com. thwt. layout. *; 

/** 

* The <coGe> JavaTest3ench</code> class implements the GuI for testing 

* the agent interface. 

* 

* ^author Kin Boon Kwang 

* 0^version 1.0, 01 October 2000 

♦/ 

public class JavaTestBench extends JApplet { 
boolean isStandalone - false? 

String!] tupIeTvpes ^ { “STRING"."BOOLEAN","INTEGER". "FLOAT", "LONG", "DOUBLE", 
"QUEUB", "STACK" >; 

PerformActions perform; 

Vector vectorlD = new Vector(); 

Vector vectorOutput = new- Vector!) ? 

JPanel j Panel 1 == new JPaneX (); 

Smart Layout smartLayoutl = new SmartLayout (); 

JButton cmdClose - new JButton{); 

SmartLayout smartLayout2 = new SmartLayout(); 

JLabel txtStatus new JLabel (); 
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JPanel jPanel2 = new JPanel{); 

JLabel jLabelCl = new JLabel(); 

JLabel jLabelC2 = new JLabel(); 

JScrollPane listOutputScroll = new JScrollPane(); 
JButton cmdlnitSpace = new JButtonO; 

JButton cmdStopEvent = new JButton(); 

JTextField txtID = new JTextField(); 

JList listID = new JListO; 

SmartLayout smartLayoutLeft = new SmartLayout{); 
JTextField txtLookupURL = new JTextField(}; 
JTextField txtTimeout = new JTextField(); 
JTextField txtLease = new JTextField0; 

JButton cmdRead = new JButtonO; 

JPanel jPanelTop = new JPanel(); 

JCheckBox checkTimeout = new JCheckBox{); 
JTextField txtLookupGroup = new JTextField () ,- 
JButton cmdTake = new JButtonO; 

JButton cmdTxnAbort = new JButton(); 

JTextField txtSpaceName = new JTextField(); 

JButton cmdClean := new JButtonO; 

JButton cmdClear = new JButtonO; 

JCheckBox checkLease = new JCheckBox(); 

JTextField txtinput = new JTextField(); 

SmartLayout smartLayoutMain = new SmartLayout(); 
SmartLayout smartLayoutRightl = new SmartLayout{}; 
JButton cmdTxnClose = new JButtonO; 

JPanel jPanelLeft = new JPanel(); 

SmartLayout smartLayoutLef tl = new SmartLayout O ; 
JButton cmdRefresh = new JButtonO ; 

SmartLayout smartLayoutRight = new SmartLayout () ; 
JPanel jPanelRightl = new JPanel{); 

JButton cmdStartEvent = new JButtonO; 

JComboBox cbType = new JComboBox(tupleTypes); 
JLabel jLabelAO = new JLabel(); 

JLabel jLabelAl = new JLabelO; 

JScrollPane listIDScroll = new JScrollPane(); 
JLabel jLabelA2 = new JLabel(); 

JLabel jLabelAS = new JLabelO; 

JLabel jLabelA4 = new JLabel{); 

JLabel jLabelAS = new JLabeK); 

SmartLayout smartLayoutTop = new SmartLayout(); 
JTextField txtCodebase = new JTextField(); 

JLabel jLabelBO = new JLabel(); 

JLabel jLabelBl = new JLabel(); 

JLabel jLabelB3 = new JLabeK); 

JList listOutput = new JListO; 

JTextField txtTransaction = new JTextField(); 
JButton cmdPut = new JButtonO; 

JPanel jPanelMain = new JPanel(); 

JPanel jPanelLeftl = new JPanel(); 

JTextField txtSecurityPolicy = new JTextField(); 
JButton cmdRemove = new JButton(); 

JPanel jPanelRight = new JPanelO; 

JButton cmdCreate = new JButtonO; 

JButton cmdTxnStart = new JButton(); 

JLabel jLabelCO = new JLabeK); 

JButton cmdSearch = new JButtonO; 

JButton cmdUpdate = new JButtonO; 

//Construct the applet 
public JavaTestBench () { 

} 

//Initialize the JavaTestBench 
public void initO { 
try { 
jblnitO ; 

listlD.setListData(vectorlD); 
listOutput.setListData{vectorOutput); 
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perform = new PerformActions (this) ; 

} 

catch(Exception e) { 
e.printStackTrace(); 

} 


//Component initialization 
private void jblnit() throws Exception { 
this.setSize(new Dimension(518, 488)); 
j Panel1.setLayout(smartLayoutl); 

cmdClose.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdClose_actionPerformed(e); 

} 

}); 

cmdClose.setText("Close”); 

cmdClose.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtStatus.setFont(new java.awt.Font("Dialog"/ 0, 11)); 
txtStatus.setBorder(BorderFactory.createLoweredBevelBorder()) ; 
jPanel2.setBorder(BorderFactory.createEtchedBorder()); 
j Panel2.setLayout(smartLayout2) ; 

jLabelCl.setFont(new java.awt.Font("SansSerif", 0, 10)); 
jLabelCl.setText("Transaction :"); 
j LabelC2.setText("Input"); 

j LabelC2.setHorizontalTextPosition(SwingConstants.CENTER); 
jLabelC2.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdInitSpace.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdinit Space_ac tionPerf ormed(e); 

} 

}); 

cmdinitSpace.setText{"Init Space"); 

cmdinitSpace.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdinitSpace.setMargin(new Insets(2, 2, 2, 2)); 
cmdStopEvent.setMargin(new Insets(2, 2, 2, 2)); 
cmdStopEvent.setEnabled(false); 

cmdStopEvent.setFont(new j ava.awt.Font("SansSerif", 0, 10)); 
cmdStopEvent.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdStopEvent_actionPerf ormed (e) ; 

} 

}); 

cmdStopEvent.setText{"StopEvent"); 

txtID.setFont(new java.awt.Font{"Dialog", 0, 10)); 
txtID.setText("EntrylD”); 

listlD.addMouseListener(new java.awt.event.MouseAdapterO { 

public void mouseClicked(MouseEvent e) { 
listID_mouseClicked(e); 

} 

}); 

listlD.setBorder(BorderFactory.createEtchedBorder()); 
listID.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtLookupURL.setText(""); 

txtLookupURL.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtTimeout.setText("3000"); 

txtTimeout.setHorizontalAlignment(SwingConstants.RIGHT); 
txtTimeout.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtLease.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtLease.setText("60000") ; 

txtLease.setHorizontalAlignment(SwingConstants.RIGHT); 
cmdRead.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdRead_actionPerformed(e); 
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} 

}) ; 

cmdRead. setText (’’Read") ; 
cmdRead.setEnabled(false); 

cmdRead.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdRead.setMargin(new Insets(2, 2, 2, 2)); 
jPanelTop.setBorder(BorderFactory.createEtchedBorder()); 
jPanelTop.setLayout(smartLayoutTop); 

checkTimeout.setFont(new java.awt.Font{"SansSerif*, 0, 10)); 
checkTimeout.setSelected(true); 
checkTimeout.setText("TimeOut"); 

txtLookupGroup. setFont (new java,awt .Font ('’Dialog", 0, 10)); 
txtLookupGroup.setText(""); 
cmdTake.setText("Take"); 

cmdTake.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerfonned{ActionEvent e) { 
cmdTake_actionPerfonned(e) ; 

} 

}); 

cmdTake.setEnabledCfalse); 

cmdTake.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdTake.setMargin(new Insets(2, 2, 2, 2)); 
cmdTxnAbort.setText("Abort"); 

cmdTxnAbort.addActionListener(new java.awt.event.ActionListener{) { 

public void actionPerformed(ActionEvent e) { 
cmdTxnAbort_actionPerformed(e); 

} 

}); 

cmdTxnAbort.setEnabled(false); 

cmdTxnAbort.setFont(new j ava.awt.Font("SansSerif", 0, 10)); 
cmdTxnAbort.setMargin(new Insets (2, 2, 2, 2)); 
txtSpaceName.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtSpaceName.setText(""); 
cmdClean.setText("Clean Up"); 

cmdClean.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdClean_actionPerformed(e); 

} 

}); 

cmdClean.setEnabled(false); 

cmdClean.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdClean.setMargin(new Insets(2, 2, 2, 2)); 
cmdClear.setMargin(new Insets(2, 2, 2, 2)); 
cmdClear.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdClear.setText("Clear"); 

cmdClear.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdClear_actionPerformed(e); 

} 

}); 

checkLease.setSelected(true); 
checkLease.setText{"Lease"); 

checkLease.setFont(new java.awt.Font("SansSerif", 0, 10)); 
txtinput.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtlnput.setText("A simple message"); 
cmdTxnClose.setText("End"); 

cmdTxnClose. addAc tionListener (new j ava. awt. event. Ac tionListener () { 

public void actionPerformed(ActionEvent e) { 
cmdTxnClose_actionPerformed(e); 

} 

}); 

cmdTxnClose.setEnabled(false); 

cmdTxnClose.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdTxnClose.setActionCommand("Close"); 
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cmdTxnClose.setMargin{new Insets(2/ 2, 2, 2)); 
jPanelLeft.setBorder(BorderFactory.createEtchedBorder()); 
jPanelLeft.setLayout(smartLayoutLeft); 
cmdRefresh.setText("Refresh"); 

cmdRefresh.addActionListener(new java.awt.event.ActionListener{} { 

public void actionPerformed(ActionEvent e) { 
cindRefresh_actionPerfonned(e) ; 

} 

}); 

cmdRefresh.setFont(new java.awt.Font("SansSerif"/ 0, 10)); 
cmdRefresh.setMargin(new Insets(2, 2, 2, 2)); 

jPanelRightl.setBorder(BorderFactory.createLoweredBevelBorder()); 
jPanelRightl.setLayout(smartLayoutRightl); 
cmdStartEvent.setText("StartEvent"); 

cmdStartEvent.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdStartEvent_actionPerformed(e); 

} 

}); 

cmdStartEvent.setEnabled(false); 

cmdStartEvent.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdStartEvent.setMargin(new Insets{2, 2, 2, 2)); 
cbType.setFont(new java.awt.Font("Dialog", 1, 10)); 
cbType.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed (ActionEvent e) { 
cbType_actionPerformed (e); 

} 

}); 

jLabelAO.setText{"Agent Setting"); 

jLabelAO-setFont(new java.awt.Font("Dialog", 1, 12)); 
jLabelAl.setFont(new java.awt.Font("SansSerif", 0, 10)); 
jLabelA1.setText("Security Policy"); 

jLabelA2.setFont(new java.awt.Font("SansSerif", 0, 10)); 
j LabelA2.setText("Space Name"); 

jLabelAS.setFont(new java.awt.Font("SansSerif", 0, 10)); 
jLabelA3.setText("Server Codebase"); 

jLabelA4.setFont(new java.awt.Font("SansSerif", 0, 10)); 
jLabelA4.setText("Lookup Group"); 

jLabelAS.setFont(new java.awt.Font("SansSerif", 0, 10)); 

jLabelA5.setText{"Lookup URL"); 

txtCodebase.setFont(new java.awt .Font("Dialog", 0, 10)); 
txtCodebase.setText(""); 

jLabelBO.setFont(new java.awt.Font("Dialog", 1, 12)); 
jLabelBO.setHorizontalAlignment(SwingConstants.CENTER); 
j LabelBO.setText("Parameters "); 
jLabelBl.setText("Type"); 

jLabelBl.setFont(new java.awt.Font("SansSerif", 0, 10)); 
jLabelBS.setText("ID"); 

jLabelB3.setFont(new java.awt.Font("SansSerif", 0, 10)); 
jLabelBS. setHorizontalAlignment (SwingConstants.CENTER) ; 
listOutput.setBackground(Color.black); 

listOutput.setFont(new java.awt.Font("Dialog", 0, 10)); 
listOutput.setForeground(Color.green); 

1istOutput.setBorder(BorderFactory.createEtchedBorder()); 
txtTransaction.setText(""); 

txtTransaction.setFont(new java.awt.Font("SansSerif", 0, 10)); 

cmdPut.setText("Put"); 

cmdPut.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdPut_actionPerformed(e) ; 

} 

}); 

cmdPut.setEnabled(false); 

cmdPut.setFont(new j ava.awt.Font("SansSerif", 0, 10)); 
cmdPut.setMargin(new Insets{2, 2, 2, 2)); 
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jPanelMain.setLayout(smartLayoutMain); 

jPanelLeftl-setBorder(BorderFactory.createLoweredBevelBorder()); 
jPanelLeftl.setLayout{smartLayoutLeftl); 

txtSecurityPolicy.setFont(new java.awt.Font("Dialog", 0, 10)); 
txtSecurityPolicy.setText(""); 
cmdRemove. setText ("Remove") ; 

cmdRemove.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdRemove_actionPerfonned(e) ; 

} 

}); 

cmdRemove.setEnabled(false); 

cmdRemove.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdRemove.setMargin(new Insets(2, 2, 2, 2)); 
j PanelRight.setBorder(BorderFactory.createEtchedBorder()); 
j PanelRight. setLayout (smartLayoutRight); 
cmdCreate.setText("Create"); 

cmdCreate.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdCreate_actionPerformed(e); 

} 

}); 

cmdCreate.setEnabled(false); 

cmdCreate.setFont(new j ava.awt.Font("SansSerif", 0, 10)); 
cmdCreate.setMargin(new Insets(2, 2, 2, 2)); 
cmdTxnStart.setMargin(new Insets(2, 2, 2, 2)); 
cmdTxnStart.setBackground(new java.awt.Color(204, 204, 204)); 

cmdTxnStart.setEnabled(false); 
cmdTxnStart.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdTxnStart.setText("Start"); 

cmdTxnStart.addActionListener(new java.awt.event.ActionListener() { 
public void actionPerformed(ActionEvent e) { 
cmdTxnStart_actionPerformed(e); 

} 

}) ; 

jLabelCO.setText("Space Window"); 

jLabelCO.setHorizontalAlignment(SwingConstants.CENTER); 
jLabelCO.setFont(new java.awt.Font("Dialog", 1, 12)); 
cmdSearch-setMargin(new Insets(2, 2, 2, 2)); 

cmdSearch.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdSearch.addActionListener(new java.awt .event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdSearch_actionPerformed{e); 

> 

}) ; 

cmdSearch.setText("Search"); 

cmdUpdate.setMargin(new Insets(2, 2, 2, 2)); 

cmdUpdate.setEnabled(false); 

cmdUpdate.setFont(new java.awt.Font("SansSerif", 0, 10)); 
cmdUpdate.addActionListener(new java.awt.event.ActionListener() { 

public void actionPerformed(ActionEvent e) { 
cmdUpdate_actionPerformed{e); 

} 

}); 

cmdUpdate.setText("Update"); 

this.getContentPane().add(j Panel1, BorderLayout.CENTER); 
jPanell.add(jPanelMain, new com.thwt.layout.LayoutConstraint( 
new com. thwt .layout .FixedDimensionAnchor(Anchor,Width, 505), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 453), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 0), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 0))); 
jPanelMain.add(jPanelTop, new com,thwt.layout.LayoutConstraint{ 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Height, 120), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 0), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 0), 
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new coin.thwt.layout.EdgeAnchor(jPanelRight, Anchor .Right/ Anchor. Same, 

Anchor.Right, 0))); 

jPanelTop.add(jLabelA2/ new com.thwt.layout.LayoutConstraint( 

new com.thwt.layout.EdgeAnchor(jLabelA1, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0) , 

new com.thwt.layout.EdgeAnchor{jLabelA1, Anchor.Left, Anchor.Same, Anchor.Left, 

0) , 

new com. thwt. layout. EdgeAnchor{j Label Al, Anchor .Width, Anchor. Same, Anchor .Width, 

0) , 

new com.thwt.layout.EdgeAnchor(jLabelAl, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 

jPanelTop.add{jLabelA3, new com.thwt.layout.LayoutConstraint( 

new com.thwt.layout.EdgeAnchorCjLabelA2, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0), 

new com.thwt.layout.EdgeAnchor(jLabelAl, Anchor.Left, Anchor.Same, Anchor.Left, 

0) , 

new com.thwt.layout.EdgeAnchor(jLabelAl, Anchor.Width, Anchor.Same, Anchor.Width, 

0) , 

new com. thwt. layout. Edge Anchor (j Label Al, Anchor. Height, Anchor. Same, 

Anchor.Height, 0))); 

j PanelTop.add(j LabelA4, new com. thwt.layout.LayoutConstraint( 

new com-thwt.layout.EdgeAnchor(jLabelAS, Anchor-Bottom, Anchor.Below, Anchor.Top, 

0), 

new com. thwt. layout. EdgeAnchor (j Label Al, Anchor. Left, Anchor. Same, Anchor. Left, 

0) , 

new com. thwt. layout. EdgeAnchor (jLabelAl, Anchor-Width, Anchor.Same, Anchor .Width, 

0), 

new com. thwt. layout. EdgeAnchor (jLabelAl, Anchor, Height, Anchor. Same, 

Anchor.Height, 0))); 

jPanelTop.add(jLabelAS, new com.thwt.layout.LayoutConstraint( 

new com.thwt.layout.EdgeAnchor(jLabelA4, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0), 

new com. thwt. layout-EdgeAnchor (jLabelAl, Anchor. Left, Anchor. Same, Anchor. Left, 

0) , 

new com. thwt. layout. EdgeAnchor (jLabelAl, Anchor .Width, Anchor. Same, Anchor .Width, 

0) , 

new com.thwt.layout.EdgeAnchor(j LabelAl, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))) ; 

j PanelTop.add(txtSecurityPolicy, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout. FixedDimen si onAnchor( Anchor. Width, 280), 
new com. thwt .layout. FixedDimensionAnchor( Anchor. Height, 18), 

new com.thwt.layout.EdgeAnchor(jLabelAl, Anchor.Right, Anchor.Right, Anchor.Left, 

0), 

new com. thwt. layout. EdgeAnchor (jLabelAl, Anchor. Top, Anchor. Same, Anchor. Top, 

0))); 

jPanelTop.add(txtSpaceName, new com.thwt.layout.LayoutConstraint( 

new com.thwt.layout.EdgeAnchor(jLabelA2, Anchor.Right, Anchor.Right, Anchor.Left, 

0) , 

new com. thwt. lay out. EdgeAnchor (j Label A2, Anchor.Top, Anchor.Same, Anchor.Top, 0), 
new com. thwt. layout. EdgeAnchor (txtSecurityPolicy, Anchor .Width, Anchor. Same, 
Anchor.Width, 0), 

new com.thwt.layout.EdgeAnchor(txtSecurityPolicy, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 

j PanelTop-add(txtCodebase, new com.thwt.layout.LayoutConstraint( 

new com.thwt.layout.EdgeAnchor(jLabelA3, Anchor.Right, Anchor.Right, Anchor.Left, 

0) , 

new com. thwt. layout. EdgeAnchor(j Label A3, Anchor. Top, Anchor. Same, Anchor. Top, 0), 
new com. thwt. layout, EdgeAnchor (txtSecurityPolicy, Anchor .Width, Anchor.Same, 

Anchor.Width, 0), 

new com.thwt.layout.EdgeAnchor(txtSecurityPolicy, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 

j PanelTop.add(txtLookupGroup, new com.thwt.layout.LayoutConstraint( 

new com.thwt.layout.EdgeAnchor(jLabelA4, Anchor.Right, Anchor.Right, Anchor.Left, 

0), 

new com.thwt-layout.EdgeAnchor(jLabelA4, Anchor.Top, Anchor.Same, Anchor-Top, 0), 
new com.thwt.layout.EdgeAnchor(txtSecurityPolicy, Anchor.Width, Anchor.Same, 

Anchor-Width, 0), 

new com.thwt.layout.EdgeAnchor(txtSecurityPolicy, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 
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jPanelTop. add (txtLookupURL, new com. thwt. layout .LayoutConstraint ( 

new com.thwt.layout.EdgeAnchor{jLabelA5, Anchor.Right, Anchor.Right, Anchor.Left, 

new com.thwt.layout.EdgeAnchorljLabelA5, Anchor.Top, Anchor.Same, Anchor.Top, 0), 
new com.thwt.layout.EdgeAnchor{txtSecurityPolicy, Anchor.Width, Anchor.Same, 

Anchor.Width, 0), 

new com.thwt.layout.EdgeAnchor(txtSecurityPolicy. Anchor.Height, Anchor.Same, 

Anchor.Height, 0}}); 

jPaneiTop.add(cmdinitspace, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 70), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 24), 
new com.thwt.layout.ContainerAnchor{Anchor.Left, 426), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 85))); 
jPanelTop.add(jLabelAl, new com.thwt,layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 110), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 18), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 14), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 26))); 
jPanelTop.add(jLabelAO, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 110), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 16), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 217), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 1))); 
jPanelMain.add(jPanelLeft, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Width, 175), 
new com. thwt. layout .ContainerAnchor (Anchor .Bottom, 0), 

new com.thwt.layout.EdgeAnchor(jPanelTop, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0) , 

new com.thwt.layout.EdgeAnchor(jPanelTop, Anchor.Left, Anchor.Same, Anchor.Left, 

0))); 

jPanelLeft.add(checkTimeout, new com.thwt.layout.LayoutConstraint ( 

new com.thwt.layout.EdgeAnchor(checkLease, Anchor.Bottom, Anchor.Below, 

Anchor.Top, 0), 

new com.thwt.layout.EdgeAnchor(checkLease, Anchor.Left, Anchor.Same, Anchor.Left, 

0) , 

new com.thwt. layout. EdgeAnchor (checkLease, Anchor .Width, Anchor. Same, 

Anchor .Width, 0) , 

new com. thwt. layout. EdgeAnchor (checkLease, Anchor .Height, Anchor. Same, 

Anchor.Height, 0))); 

jPanelLeft.add(txtLease, new com.thwt.layout.LayoutConstraint( 
new com.thwt .layout. FixedDimensionAnchor (Anchor. Width, 80), 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Height, 18), 

new com.thwt.layout .EdgeAnchor (checkLease, Anchor .Right, Anchor .Right, 

Anchor.Left, 0), 

new com.thwt.layout.EdgeAnchor(checkLease, Anchor.Top, Anchor.Same, Anchor.Top, 

0))); 

j Panel Left. add (txtTimeout, new com. thwt. layout. LayoutConstraint ( 
new com.thwt .layout .FixedDimensionAnchor (Anchor .Width, 80), 
new com.thwt .layout .FixedDimensionAnchor (Anchor. Height, 18), 

new com. thwt.layout.EdgeAnchor(checkTimeout, Anchor.Right, Anchor.Right, 

Anchor.Left, 0), 

new com. thwt. layout. EdgeAnchor (checkTimeout, Anchor. Top, Anchor. Same, Anchor. Top, 

0))); 

jPanelLeft .add (checkLease, new com. thwt. layout .LayoutConstraint ( 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Width, 70), 
new com. thwt. layout. FixedDimensionAnchor (Anchor.Height, 18), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 13), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 28))); 
jPanelLeft.add(jLabelBO, new com.thwt.layout.LayoutConstraint( 
new com.thwt .layout. FixedDimensionAnchor (Anchor. Width, 110), 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Height, 16), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 41), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 3))); 
j Panel Lef t. add (cbType, new com. thwt. layout .LayoutConstraint ( 
new com. thwt .layout .FixedDimensionAnchor (Anchor. Width, 112), 
new com.thwt .layout .FixedDimensionAnchor (Anchor. Height, 18), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 52), 
new com. thwt. layout. Container Anchor (Anchor .Top, 76))); 
jPanelLef t .add( jPanelLef tl, new com. thwt. layout .LayoutConstraint { 
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new com.thwt.layout.ContainerAnchor{Anchor.Left, 5), 
new com. thwt.layout.ContainerAnchor(Anchor.Right/ 5), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 100), 
new com.thwt.layout.ContainerAnchor(Anchor.Bottom, 5))); 
jPanelLeftl.add(cmdRemove, new com.thwt.layout.LayoutConstraint{ 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0) , 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Left, Anchor.Same, Anchor.Left, 

0) , 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Width, Anchor.Same, Anchor.Width, 

0) , 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 

jPanelLef tl .add(cmdClean, new com. thwt. layout .LayoutConstraint ( 
new com. thwt. layout. EdgeAnchor (cmdRemove, Anchor .Bottom, Anchor .Below, Anchor.Top, 10), 
new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Left, Anchor.Same, Anchor.Left, 0), 
new com. thwt. layout. Edge Anchor (cmdCreate, Anchor .Width, Anchor.Same, Anchor .Width, 0), 
new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Height, Anchor.Same, Anchor.Height, 
0) )) ; 

jPanelLeftl.add{cmdStartEvent, new com. thwt. layout.LayoutConstraint { 

new com.thwt.layout.EdgeAnchor(cmdClean, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0) , 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Left, Anchor.Same, Anchor.Left, 

0) , 

new com.thwt .layout .EdgeAnchor (cmdCreate, Anchor .Width, Anchor. Same, Anchor .Width, 

0) , 

new com. thwt. layout. EdgeAnchor (cmdCreate, Anchor. Height, Anchor. Same, 

Anchor.Height, 0))); 

j PanelLef tl. add (cmdRefresh, new com. thwt. layout. LayoutConstraint ( 
new com. thwt. layout .ContainerAnchor (Anchor. Bottom, 10), 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Left, Anchor.Same, Anchor.Left, 

0) , 

new com. thwt. layout .EdgeAnchor (cmdCreate, Anchor .Width, Anchor. Same, Anchor .Width, 

0) , 

new com.thwt.layout.EdgeAnchor(cmdCreate, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 

jPanelLeftl.add(cmdCreate, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 60), 
new com.thwt. layout. FixedDimensionAnchor (Anchor. Height, 20) , 
new com.thwt .layout. ContainerAnchor (Anchor. Left, 5), 
new com. thwt. layout.ContainerAnchor (Anchor .Top, 41))); 
jPanelLeftl.add(jLabelBB, new com.thwt.layout.LayoutConstraint( 
new com.thwt .layout. FixedDimensionAnchor (Anchor. Width, 60), 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Height, 16), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 13), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 11))); 
jPanelLeftl.add(txtID, new com.thwt.layout.LayoutConstraint{ 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Width, 80), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 18), 

new com.thwt.1ayout.EdgeAnchor(jLabelB3, Anchor.Right, Anchor.Right, Anchor.Left, 

0) , 

new com.thwt.layout.EdgeAnchor(jLabe1B3, Anchor.Top, Anchor.Same, Anchor.Top, 

0))); 

jPanelLeftl.add(listIDScroll, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout .FixedDimensionAnchor (Anchor. Width, 90), 
new com.thwt. layout. ContainerAnchor (Anchor. Left, 66), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 41), 
new com.thwt .layout. ContainerAnchor (Anchor. Bottom, 10))); 
j PanelLef tl. add (cmdStopEvent, new com. thwt. layout. LayoutConstraint ( 
new com.thwt.layout.EdgeAnchor(cmdStartEvent, Anchor.Bottom, Anchor.Below, Anchor.Top, 
0) , 

new com.thwt. layout. EdgeAnchor (cmdClean, Anchor.Left, Anchor.Same, Anchor.Left, 0), 
new com. thwt. layout .EdgeAnchor (cmdClean, Anchor .Width, Anchor.Same, Anchor .Width, 0), 
new com. thwt .layout. EdgeAnchor (cmdClean, Anchor .Height, Anchor.Same, Anchor .Height, 0))); 

jPanelLeftl.add(cmdSearch, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout. Edge Anchor (cmdRefresh, Anchor.Top, Anchor. Above, Anchor .Bottom, 0), 
new com.thwt .layout. EdgeAnchor (cmdClean, Anchor.Left, Anchor.Same, Anchor.Left, 0), 
new com.thwt. layout. Edge Anchor (cmdClean, Anchor .Width, Anchor.Same, Anchor .Width, 0), 
new com.thwt. layout. Edge Anchor (cmdClean, Anchor .Height, Anchor. Same, Anchor .Height, 0))); 
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jPanelLeft.add(jLabelBl, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout .FixedDimensionAnchor (Anchor-Width, 70), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 16), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 19), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 11))); 
jPanelMain.add(jPanelRight, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout.FixedDimensionAnchor (Anchor.Width, 330), 

new com.thwt.layout.EdgeAnchor(j PanelLeft, Anchor.Right, Anchor.Right, 

Anchor.Left, 0), 

new com.thwt.layout.EdgeAnchor(jPaneiTop, Anchor.Bottom, Anchor.Below, Anchor.Top, 

0), 

new com.thwt .layout .EdgeAnchor (j PanelLef t. Anchor. Height, Anchor. Same, 

Anchor.Height, 0))); 

j PanelRight. add (cmdTxnAbort, new com. thwt. layout. LayoutConstraint ( 

new com.thwt.layout.EdgeAnchor(cmdTxnStart, Anchor.Right, Anchor.Right, 

Anchor.Left, 0), 

new com.thwt.layout.EdgeAnchor(cmdTxnStart, Anchor.Top, Anchor.Same, Anchor.Top, 

0), 

new com. thwt. 1 ayout. EdgeAnchor (cmdTxnStart, Anchor. Width, Anchor. Same, 

Anchor.Width, 0), 

new com. thwt. layout. EdgeAnchor (cmdTxnStart, Anchor. Height, Anchor. Same, 

Anchor.Height, 0))); 

jPanelRight.add(cmdTxnClose, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.EdgeAnchor(cmdTxnAbort, Anchor.Right, Anchor.Right, Anchor.Left, 0), 

new com.thwt.layout.EdgeAnchor(cmdTxnAbort, Anchor.Top, Anchor.Same, Anchor.Top, 

0), 

new com. thwt. layout. EdgeAnchor (cmdTxnAbort, Anchor .Width, Anchor. Same, 

Anchor .Width, 0) , 

new com. thwt. layout. EdgeAnchor (cmdTxnAbort, Anchor .Height, Anchor. Same, 

Anchor.Height, 0))); 

j PanelRight.add(j LabelCO, new com. thwt.layout.LayoutConstraint( 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Width, 85), 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Height, 17), 
new com. thwt.layout.ContainerAnchor(Anchor.Left, 108), 
new com. thwt. layout. ContainerAnchor (Anchor. Top, 2))) ; 
j PanelRight.add(txtTransaction, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Width, 100), 
new com. thwt.layout .FixedDimensionAnchor (Anchor.Height, 18), 
new com. thwt. layout .ContainerAnchor (Anchor. Left, 68), 
new com. thwt. layout. ContainerAnchor (Anchor.Top, 26))); 
j PanelRight.add(j LabelCl, new com-thwt.layout.LayoutConstraint( 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Width, 110), 
new com.thwt. layout. FixedDimensionAnchor (Anchor. Height, 16), 
new com. thwt. layout.ContainerAnchor (Anchor. Lef t, 4) , 
new com. thwt. layout.ContainerAnchor (Anchor. Top, 25))) ; 
j PanelRight.add(cmdTxnStart, new com.thwt.layout.LayoutConstraint{ 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Width, 50), 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Height, 20), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 169), 
new com. thwt. layout. ContainerAnchor (Anchor.Top, 24))) ; 
j PanelRight.add(j PanelRight1, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout. Container Anchor (Anchor. Left, 5), 
new com. thwt. layout. ContainerAnchor (Anchor. Right, 5), 
new com. thwt. layout.ContainerAnchor (Anchor-Top, 51), 
new com. thwt. layout. ContainerAnchor (Anchor. Bottom, 5))),- 
jPanelRightl.add(cmdPut, new com.thwt.layout.LayoutConstraint( 
new com.thwt. layout. FixedDimensionAnchor (Anchor. Width, 50), 
new com.thwt. layout. FixedDimensionAnchor (Anchor. Height, 20), 

new com. thwt. layout. Edge Anchor (txt Input, Anchor .Right, Anchor .Right, Anchor.Left, 

0), 

new com.thwt.layout.EdgeAnchor(txtInput, Anchor.Top, Anchor.Same, Anchor.Top, 

0))); 

jPanelRightl.add(jLabelC2, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Width, 110), 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Height, 20), 
new com. thwt. layout. ContainerAnchor (Anchor. Lef t, 18), 
new com. thwt .layout.ContainerAnchor (Anchor. Top, 11))); 
jPanelRightl.add(txtInput, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout. FixedDimensionAnchor (Anchor. Width, 130), 
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new com.thwt.layout-FixedDimensionAnchor(Anchor-Height, 20), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 55), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 13))) ; 
j PanelRight1- add(cmdRead, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 50), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 20), 

new com.thwt.layout.EdgeAnchor(cmdTake, Anchor.Right, Anchor.Right, Anchor.Left, 

0), 

new com.thwt.layout.EdgeAnchor(cmdTake, Anchor.Top, Anchor.Same, Anchor.Top, 0))); 
jPanelRightl.add(listOutputScroll, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 303), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 198), 
new com.thwt.1ayout.ContainerAnchor(Anchor.Left, 5), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 40))); 
jPanelRightl.add(cmdTake, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout. FixedDimensionAnchor (Anchor .Width, 50) , 
new com. thwt. layout .FixedDimensionAnchor (Anchor .Height, 20), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 240), 

new com.thwt.layout.EdgeAnchor(listOutputScroll, Anchor.Left, Anchor.Same, 

Anchor.Left, 0))); 

jPane1Rightl.add(cmdClear, new com.thwt.layout.LayoutConstraint( 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Width, 50), 
new com. thwt. layout.FixedDimensionAnchor (Anchor.Height, 20), 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 258), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 239))); 
jPanelRightl.add(cmdUpdate, new com.thwt.layout.LayoutConstraint( 

new com. thwt.layout.EdgeAnchor(cmdPut, Anchor.Right, Anchor.Right, Anchor.Left, 

0) , 

new com. thwt. layout.EdgeAnchor (cmdPut, Anchor.Top, Anchor. Same, Anchor.Top, 0) , 
new com.thwt .1 ayout. Edge Anchor (cmdCl ear. Anchor .Width, Anchor. Same, Anchor .Width, 

0) , 

new com.thwt.layout.EdgeAnchor(cmdClear, Anchor.Height, Anchor.Same, 

Anchor.Height, 0))); 

jPanel1.add(jPanel2, new com.thwt.layout.LayoutConstraint( 

new com. thwt. layout. FixedDimensionAnchor (Anchor .Width, 505), 
new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 31), 
new com.thwt.layout.ContainerAnchor(Anchor-Left, 0), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 453))>; 
j Panel2.add(cmdClose, new com.thwt.layout.LayoutConstraint( 
new com. thwt. layout. FixedDimensionAnchor (Anchor .Width, 79) , 

new com.thwt.layout.FixedDimensionAnchor(Anchor.Height, 22), 
new com.thwt.layout.ContainerAnchor(Anchor.Right, 5), 
new com.thwt. layout .ContainerAnchor (Anchor. Top, 2))),- 
jPanel2.add(txtStatus, new com. thwt.layout.LayoutConstraint( 

new com.thwt. layout .FixedDimensionAnchor (Anchor .Width, 413) , 
new com. thwt. layout. FixedDimensionAnchor (Anchor .Height, 21) , 
new com.thwt.layout.ContainerAnchor(Anchor.Left, 3), 
new com.thwt.layout.ContainerAnchor(Anchor.Top, 2))); 
listOutputScroll.getviewport().adddistOutput, null); 
listIDScroll-getViewport () .adddistID, null); 

} 

//Start the applet 
public void start() { 

} 

//Stop the applet 
public void stopO { 

} 

//Destroy the applet 
public void destroy() { 

} 

//Get Applet information 
public String getAppletInfo() { 
return "Applet Information"; 


} 




//Get parameter info 

public String[][] getParameterInfo() { 
return null; 

} 

//Main method 

public static void main(String[] args) { 

Appletl applet = new JavaTestBenchO; 
applet.isStandalone = true; 

JFrame frame = new JFrame (); 

frame.setTitie{"Space Agent Test Bench"); 

frame.getContentPane () .add(applet, BorderLayout.CENTER) ; 

applet.initO ; 

applet.start() ; 

frame.setSize(515,510); 

Dimension d = Toolkit.getDefaultToolkitO.getScreenSizeO; 

frame.setLocation((d.width - frame.getSize().width) / 2, (d.height 

frame.getSize().height) / 2); 
frame.setVisible(true); 

} 

11 static initializer for setting look & feel 
static { 
try { 

UIManager.setLookAndFeel ( "com.sun. java.swing-plaf.windows.MetalLookAndFeel") ; 

/ /UIManager. setLookAndFeel (UIManager. getSystemLookAndFeelClassName ()) ; 
//UIManager.setLookAndFeel(UIManager.getCrossPlatformLookAndFeelClassName()); 

} 

catch (Exception e) {} 


void cmdTxnStart_actionPerformed(ActionEvent e) { 
cmdPut.setBackground(Color.red); 
cmdupdate.setBackground(Color.red); 
cmdRead. setBackground (Color .red) ; 
cmdTake. setBackground (Color. red); 
cmdStartEvent. setBackground (Color. red) ; 
txtTransaction.setText ("Running. .."); 

txtStatus.setText(" Start Transaction Manager ->" + perform.startTransaction()); 

} 

void cmdTxnAbort_actionPerformed(ActionEvent e) { 
cmdPut.setBackground(new Color(204,204,204)); 
cmdUpdate.setBackground(new Color(204,204,204)); 
cmdRead.setBackground(new Color(204,204,204)); 
cmdTake.setBackground(new Color(204,204,204)); 
cmdStartEvent.setBackground(new Color(204,204,204)); 
txtTransaction.setText(""); 

txtStatus.setText(" Abort Transaction Manager “>" + perforTn.abortTransaction()); 

} 

void cmdTxnClose_actionPerformed(ActionEvent e) { 
cmdPut.setBackground(new Color(204,204,204)) ; 
cmdupdate.setBackground(new Color(204,204,204)); 
cmdRead.setBackground(new Color(204,204,204)); 
cmdTake.setBackground(new Color(204,204,204)); 
cmdStartEvent.setBackground (new Color(204,204,204)); 
txtTransaction.setText(""); . 

txtStatus.setText(" Close Transaction Manager + perform.closeTransaction()); 

} 

void cmdInitSpace_actionPerformed(ActionEvent e) { 
perform.initSpace(); 

} 

void cmdCreate_actionPerformed( ActionEvent e) { 

perform.createID((String) cbType.getSelectedItem()); 

} 

void cmdRemove_actionPerformed(ActionEvent e) { 
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perform.removeID((String) cbType.getSelectedItem()); 

} 

void cmdClean_actionPerformed(ActionEvent e) { 

perform.cleanSpace{(String) cbType.getSelectedItem()); 

} 

void cmdStartEvent_actionPerfoimed(ActionEvent e) { 

perform.startEvent((String) cbType.getSelectedItem()); 

} 

void cmdStopEvent_actionPerformed(ActionEvent e) { 

perform.stopEvent((String) cbType.getSelectedItern()) ; 

} 

void cmdRefresh_actionPerformed(ActionEvent e) { 

perform.refreshListIDs((String) cbType.getSelecteditern()) 

} 


void cmdTake_actionPerformed(ActionEvent e) { 

perform.takeEntry((String) cbType.getSelectedItern()); 

} 

void cmdRead_actionPerformed(ActionEvent e) { 

perform.readEntry((String) cbType.getSelectedItern()); 

> 

void cmdClear_actionPerformed(ActionEvent e) { 
perform.clearOutput(); 

) 

void cmdClose_actionPerformed(ActionEvent e) { 
perform.close(); 

System.exit(0); 

} 

void cmdPut_actionPerformed(ActionEvent e) { 

perform.putEntry((String) cbType.getSelectedItem()); 

} 


void listID_mouseClicked(MouseEvent e) { 
if (e.getClickCount() == 1) { 

int index = listID.locationToIndex(e.getPoint()); 
if(index != -1) 

perform.IDSelected(index); 


} 


void listID_mousePressed(MouseEvent e) { } 

void listID_mouseReleased(MouseEvent e) { } 

void listID_mouseEntered{MouseEvent e) { } 

void listID_mouseExited(MouseEvent e) { } 


void cbType_actionPerformed(ActionEvent e) { 

JComboBox cb = (JComboBox)e.getSource ()7 
perform.changeType( (String) cbType.getSelectedItem()); 

} 


void printClassName(Object obj) { 

System.out.printIn("The class of " + obj + 

" is " + obj-getClass().getName()); 


> 


void cmdSearch_actionPerformed(ActionEvent e) { 
perform.SearchTSClassIDs(); 

} 


void cmdUpdate_actionPerformed(ActionEvent e) { 

perform.updateEntry((String) cbType.getSelectedItem()); 

} 
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2. PerformActions.java 

package tuplespace.core; 


import java.util.Date; 
import java.util-Vector; 
import java.lang.StringBuffer; 
import javax.swing.JOptionPane; 
import javax.swing.JScrollBar; 
import java.util.EventListener; 
import j ava.awt.event.*; 
import java.awt.Cursor; 


/** 

* The <code>PerformActions</code> class handle the events for 

* the GUI. 

* 

* ©author Kin Boon Kwang 

* ©version 1.0/ 01 October 2000 
*/ 

public class PerformActions implements ActionListener{ 
private Appletl frame; 
private Agent agent; 

public PerformActions(Appletl frame) { 
this.frame = frame; 
this.agent = new Agent(); 
this.agent.addActionListener(this); 
refreshAll{); 

} 

public void initSpace(){ 

frame.getGlassPane().addMouseListener{ new MouseAdapter() {}); 

frame .getGlassPane().setCursor(Cursor.getPredefinedCursor(Cursor.WAIT^CURSOR)); 
frame.getGlassPane().setVisible(true); 

agent.setAgentSecurityPolicy (frame.txtSecurityPolicy.getText()); 
agent.setAgentSpaceName(frame.txtSpaceName.getText()); 
agent.setAgentServerCodebase(frame.txtCodebase.getText()); 
agent.setAgentLookupGroup(frame.txtLookupGroup.getText()); 
if{frame.txtLookupURL.getText().length() > 7) 

agent. setAgentLookupURL (frame. txtLookupURL. getText () ) ; 

//agent.setAgentLookupURL(frame.txtLookupURL.getText()); 
if{ agent.InitAgent(10000) ){ 

print (’’Space Services Initialised."); 
frame. cmdCreate.setEnabled(true); 
frame. cmdRefresh.setEnabled(true); 
frame. cmdRemove. setEnabled (true) ; 

}else{ 

print("Fail! to initialise services/ timeout 20 secs"); 

} 

frame.getGlassPane().setVisible(false); 

} 

public void createID(String type){ 

String tnpStr = frame.txtID.getText(); 

print ("Create "+ type + "[" + tiTpStr+ "] 

agent.createID(TSType2lnt(type)/tmpStr)); 
refreshListIDs(type); 
frame.cmdPut.setEnabled(true); 
frame. cmdUpdate. setEnabled {true); 
frame.cmdRead.setEnabled(true); 
frame.cmdTake.setEnabled(true); 
frame.cmdStartEvent.setEnabled(true); 
frame.cmdStopEvent.setEnabled(true); 
frame.cmdTxnAbort.setEnabled(true); 
frame.cmdTxnClose.setEnabled(true); 
frame.cmdTxnStart.setEnabled(true); 
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} 


public boolean startTransaction(){ 
return agent.startTransaction(); 

} 

public boolean closeTransaction(){ 
return agent.closeTransaction(); 

} 

public boolean abortTransaction(){ 
return agent.abortTransaction(); 

} 

public void close(){ 

agent.TerminateAgent(); 

} 

public void reinovelD(String type) { 

String trnpStr = frame.txtID.getText () ; 

print ("Remove "+ type + "[" + trrpStr+ "] " + 

agent.removeID(agent.getTSType(type) ,tmpStr}) ; 
refreshListIDs(type); 

} 

public void refreshIDs(){ 

//print(" String Map Keys -> " + agent.getTSStringMapKeys()); 

//refreshListIDs(); 

} 

public void cleanSpace(String type){ 

String tmpStr = frame.txtID.getTextO; 

print ("Clean "+ type + + tKpStr+ "] " + 

agent.cleanTSClass(TSType2lnt(type),tmpStr)); 

} 

boolean putEntiry(String type) { 

if{ type.coirpareTo{"BOOLEAN") == 0) { 

TSBoolean ts = (TSBoolean) agent.getTSObject( 

agent. TS_BOOLEAN, frame. txt ID. getText () ) ; 
if(ts != null){ 
try{ 

boolean tirp = Boolean.valueOf(frame.txtInput.getText()).booleanValue(); 
print("Write["+ frame.txtID.getText()+"] -> " + tnp + 

" + ts.writeB (trrp, getLeaseTime() ,agent.getTransaction())) ; 

)catch(Exception e){} 

} 

>else if( type.compareTo("INTEGER") == 0){ 

TSInteger ts = (TSInteger) agent.getTSObject( 

agent .TS_INTEGER/ frame, txt ID. getText () ) ; 
if(ts != null){ 
try{ 

int trrp = Integer.valueOf ( frame. txtinput. getText () ) . intValue () ; 
print ("Write [’’+ frame. txtID.getText ()+" ] -> " + tirp + 

" :" + ts.writeS (trrp, getLeaseTime{),agent.getTransaction())); 

}catch(Exception e){} 

} 

} 

else if( type.compareTo("FLOAT") == 0){ 

TSFloat ts = (TSFloat) agent.getTSObject( agent.TS^FLOAT,frame.txtID.getText()); 
if(ts != null){ 
try{ 

float tmp = Float.valueOf(frame.txtinput.getText()).floatValue(); 
print("Write["+ frame.txtID.getText()+"] ~> " + tmp + 

" + ts.writes (trip, getLeaseTime(),agent.getTransaction())); 

}catch(Exception e){} 

} 

} 
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else if( type.conpareTo("LONG") == 0){ 

TSLong ts = (TSLong) agent.getTSObject{ agent.TS^LONG,frame.txtID.getText()); 
if(ts I= null){ 
try{ 

long tmp = Long.valueOf(frame.txtInput.getText{)).longValue(); 
print("Write["+ frame.txtID.getText()+"] -> " + tmp + 

" + ts.writes(tmp, getLeaseTime (),agent.getTransaction())); 

}catch(Exception e){} 

} 

} 

else if( type.compareTo("DOUBLE") == 0){ 

TSDouble ts = (TSDouble) agent.getTSObject( agent.TS_DOUBLE,frame.txtID.getText()); 
if(ts != null){ 
try{ 

double tmp = Double .valueOf (frame. txt Input. getText ()) . doubleValue {) ; 
print ("Write ["+ frame, txt ID. getText () + " ] ~> " + trrp + 

" + ts.writes(tmp, getLeaseTime(),agent.getTransaction{))); 

}catch(Exception e){} 

} 

} 

else if( type.compareTo("STRING") == 0){ 

Date time = new Date(); 

String tmpStr = frame.txtinput.getText(); //+ « " + time.toGMTString(); 

TSString ts = (TSString) agent.getTSObject(agent.TS_STRING, 

frame.txtID.getText()); 

if(ts != null){ 

print("Write["+ frame.txtID.getText()+"3 -> " + tmpStr + 

" + ts.writeS (tirpStr, getLeaseTime (), agent .getTransaction())) ; 

} 

} 

else if( type.compareTo("QUEUE") == 0){ 

Date time = new Date(); 

String tirpStr = frame, txtinput .getText {) + " " + time.toGMTStringO ; 

TSQueue ts = (TSQueue) agent.getTSObject(agent.TS_QUEUE, frame.txtID.getText()); 
if(ts != null){ 

print ("Writer"+ frame. txtID.getText ()+" 3 -> " + tirpStr + « " + 

ts.writel (tmpStr) ) ; 

} 

} 

else if( type.compareTo("STACK") == 0){ 

} 

else if( type.compareTo("LINKLIST") == 0){ 

} 

else if( type.cortpareTo("HASH") ==-0){ 

Date time = new Date () ; 

TSHash tsHash = (TSHash) agent.getTSObject(agent.TS_HASH, 

frame.txtID.getText()); 

if(tsHash != null){ 

tsHash.setstring("a","String a "+time.toGMTString()); 

tsHash. setlnteger{ "b", 1234) 

tsHash.setFloat("c",(float) 1234.1234) ; 

tsHash.setLong("d",123456789); 

tsHash.setDouble("e",123456789.123456789); 

tsHash.setBoolean("f",true); 

print("Write["+ frame.txtID.getText()+"3 ~> " + 

tsHash.writel(getLeaseTime())); 

} 


} 

return true; 


void updateEntry(String type) { 
if( type.compareTo{"BOOLEAN") == 0){ 

TSBoolean ts = (TSBoolean) agent.getTSObject( 

agent.TS^BOOLEAN,frame.txtID.getText()); 
if(ts != null){ 


111 



try{ 

boolean tmp = Boolean.valueOf(fraine-txtInput.getText()).booleanValue(); 
print("Update["+ frame.txtID.getText()+"] -> " + tmp + 

" :” + ts.updates(tmp, getLeaseTime{),agent.getTransaction())); 

}catch{Exception e){} 

} 

}else if( type.compareTo("INTEGER") == 0){ 

TSInteger ts = (TSInteger) agent.getTSObject{ 

agent.TS^INTEGER,frame.txtID.getText()); 
if{ts != null){ 
try{ 

int tmp = Integer.valueOf{frame.txtInput.getText()).intValue(); 
print {"Update ["+ frame. txtID.getText ()+" ] -> " + trip + 

" + ts.updates{tmp, getLeaseTime(),agent.getTransaction())); 

}catch(Exception e){} 

} 

} 

else if( type.coipareTo ("FLOAT") == 0) { 

TSFloat ts = (TSFloat) agent.getTSObject( agent.TS^FLOAT,frame.txtID.getText()); 
if(ts != null){ 
try{ 

float tip = Float.valueOf(frame.txtInput.getText()).floatValue(); 
print("Update!"+ frame.txtID.getText()+"] -> " + tip + 

" :" + ts.updates(tip, getLeaseTime(),agent.getTransaction())); 

}catch(Exception e){} 

} 

} 

else if( type.compareTo("LONG") == 0){ 

TSLong ts = (TSLong) agent.getTSObject( agent.TS_LONG,frame.txtID.getText()); 
if(ts != null){ 
try{ 

long tip = Long.valueOf(frame.txtInput.getText()).longValue{); 
print{"Update["+ frame.txtID.getText()+"] -> " + tip + 

" :” + ts.updates(tmp, getLeaseTime(),agent.getTransaction())); 

}catch(Exception e){> 

} 

} 

else if( type.coipareTo("DOUBLE") == 0) { 

TSDouble ts = (TSDouble) agent .getTSObject ( agent .TS_DOUBLE, frame. txtID.getText ()) ; 
if(ts «- null){ 
try{ 

double tip = Double. valueOf (frame. txt Input. getText ()) . doubleValue () ; 
print("Update["+ frame.txtID.getText()+"] -> " + tip + 

" + ts.updates(tip, getLeaseTime(),agent.getTransaction())); 

}catch(Exception e){> 

} 

} 

else if( type.compareTo("STRING") == 0){ 

Date time = new Date(); 

String tmpStr = frame.txtinput .getText () ; //+ " " + time. toGMTString() ; 

TSString ts = (TSString) agent.getTSObject(agent.TS_STRING, 

frame.txtID.getText()); 

if(ts != null){ 

print("Update["+ frame.txtID.getText()+"] -> " + tmpStr + 

" + ts.updateS(tipStr, getLeaseTime(),agent.getTransaction())); 

} 

} 

else if( type.compareTo("QUEUE"> == 0){ 

/*Date time = new Date(); 

String trpStr = frame, txtinput .getText {) + " " + time. toGMTString () ,- 

TSQueue ts = (TSQueue) agent.getTSObject(agent.TS_QUEUE, frame.txtID.getText()); 

if(ts != null){ 

print ("Update!"+ frame. txtID.getText ()+" ] -> " + tipStr + " " + 

ts.updatel (tipStr) ) ; 

} */ 

} 

else if( type.compareTo("STACK") == 0){ 


112 



else if( type.coinpareTo(’’LINKLIST") == 0) { 


} 

else if( type.compareTo (’’HASH") == 0) { 

Date time = new DateO; 

TSHash tsHash = (TSHash) agent.getTSObject(agent.TS^HASH, 

frame.txtID.getText()); 

if(tsHash != null){ 

tsHash.setStringC’a", "String a "+time. toGMTString()) ; 

tsHash.setinteger("b", 1234) ; 

tsHash.setFloat("c",(float) 1234.1234); 

tsHash.setLong("d",123456789) ; 

tsHash.setDouble{"e",123456789.123456789); 

tsHash.setBoolean("f",true) ; 

print ("Update ["+ frame, txtID.getText ()+" ] -> *’ + 

tsHash.update2(getLeaseTime(),agent.getTransaction())); 

} 

} 

} 


boolean takeEntry(String type) { 
if{ type.compareTo{"BOOLEAN") == 0){ 

TSBoolean ts = (TSBoolean) agent.getTSObject( 

agent.TS_BOOLEAN,frame.txtID.getText()); 
if(ts != null){ 

print("Take["+ frame.txtID.getText()+"] -> " + 

ts.takeIfExists2(getTimeout{),agent.getTransaction())); 

} 

} 

else if( type.coirpareTo ("INTEGER") == 0) { 

TSInteger ts = (TSInteger) agent.getTSObject( 

agent.TS_INTEGER,frame.txtID.getText()); 
if(ts != null){ 

print("Take["+ frame.txtID.getText()+"] -> " + 

ts.takeIfExists2(getTimeout{),agent.getTransaction())); 

} 

} 

else if( type.compareTo("FLOAT") == 0){ 

TSFloat ts = (TSFloat) agent.getTSObject( agent.TS^FLOAT,frame.txtID.getText{)); 
if(ts != null){ 

print("Take["+ frame,txtID.getText()+"] ->«+ 

ts.takeIfExists2(getTimeout0,agent.getTransaction())); 

} 

} 

else if{ type.compareTo("LONG") == 0){ 

TSLong ts = (TSLong) agent.getTSObject( agent.TS^LONG,frame.txtID.getText()); 
if(ts != null){ 

print("Take["+ frame.txtID.getText()+"] -> " + 

ts.takeIfExists2(getTimeout0,agent.getTransaction())); 

} 

} 

else if( type.compareTo("DOUBLE") == 0){ 

TSDouble ts = (TSDouble) agent.getTSObject( agent.TS_DOUBLE,frame.txtID.getText()); 
if(ts != null){ 

print("Take["+ frame .txtID.getText()+") _> « + 

ts.takeIfExists2(getTimeout(),agent.getTransaction())); 

} 

} 

else if( type.compareTo("STRING") == 0){ 

TSString ts = (TSString) agent.getTSObject{ agent.TS_STRING,frame.txtID.getText()); 
if(ts != null){ 

print ("Take ["+ frame. txtID.getText {) + " ] -> " 

ts.takeIfExists2(getTimeout(),agent.getTransaction())); 

} 

} 

else if{ type.compareTo("QUEUE") == 0){ 
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TSQueue ts = (TSQueue) agent.getTSObject( agent.TS^QUEUE.frame.txtID.getText{)) ; 
if(ts != null){ 

print("Take["+ frame.txtID.getText{)+"] -> « + ts.takeO); 

} 

} 

else if{ type.compareTo("STACK") == 0){ 

} 

else if( type.compareToC’LINKLIST") == 0) { 


} 

else if( type.compareTo("HASH") == 0){ 

TSHash tsHash = (TSHash) agent.getTSObject(agent.TS^HASH, frame.txtID.getText() ] 
if(tsHash != null){ 

print!"Take["+ frame,txtID.getText()+"3 -> " + tsHash.takelfExists()); 


print{"tsHash[a] 
print("tsHash[b] 
print("tsHash[c] 
print("tsHash[d] 
print("tsHash[e] 
print("tsHash[f] 


String -> " + tsHash.getString("a")); 

Integer -> " + tsHash.getinteger("b")); 

Float ~> " + tsHash.getFloatC’c")) ; 

Long “> " + tsHash.getLong("d"}); 

Double -> " + tsHash.getDouble("e")); 

Boolean ~> " + tsHash.getBoolean("f")}; 


} 

return true; 


boolean readEntry(String type) { 

if( type.compareTo("BOOLEAN") == 0){ 

TSBoolean ts = (TSBoolean) 

agent.TS_BOOLEAN,frame.txtID.getText()); 
if(ts 1= null){ 

print("Read E"+ frame.txtID.getText()+"] 

ts.readIfExists2(getTimeout{),agent.getTransaction())); 

> 

} 

else if( type.compareTo("INTEGER") == 0){ 

TSInteger ts = (TSInteger) 

agent.TS_INTEGER,frame.txtID.getText()); 
if(ts != null){ 

print("Read["+ frame.txtID.getText{)+"] 

ts.readIfExists2(getTimeout(),agent.getTransaction())); 

} 


agent.getTSObj ect( 


agent.getTSObj ec t( 


} 

else if( type.coirpareTo ("FLOAT") == 0) { 

TSFloat ts = (TSFloat) agent.getTSObject( agent.TS_FLOAT,frame.txtID.getText{)); 
if(ts != null){ 

print("Read["+ frame.txtID.getText()+"] -> 

ts.readIfExists2(getTimeout(),agent.getTransaction())); 

} 


else if( type.compareTo("LONG") == 0){ 

TSLong ts = (TSLong) agent.getTSObject( agent.TS_LONG,frame.txtID.getText()); 
if(ts != null){ 

print("Read["+ ' frame.txtID.getText()+"] -> 

ts.readIfExists2(getTimeout(),agent.getTransaction())); 

} 

} 

else if{ type.compareTo("DOUBLE") == 0){ 

TSDouble ts = (TSDouble) agent.getTSObject( agent.TS^DOUBLE,frame.txtID.getText()) ; 
if(ts != null){ 

print!"Read!"+ frame.txtID.getText()+"3 -> 

ts.readIfExists2(getTimeout!),agent.getTransaction())); 

} 


} 

else if( type.coirpareTo{ "STRING") == 0){ 

TSString ts = (TSString) agent.getTSObject( agent.TS_STRING,frame.txtID.getText()); 
if(ts != null){ 

print("Read["+ frame.txtID.getText()+"] -> 

ts.readIfExists2(getTimeout(),agent.getTransaction())); 
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} 

} 

else if( type.compareTo("QUEUE") == 0){ 

TSQueue ts = (TSQueue) agent.getTSObject( agent.TS^QUEUE,frame.txtID.getText()); 
if(ts != null){ 
ts.printQueue{); 
long startindex,endindex; 
startindex = ts.getstartlndex(); 
endindex = ts.getEndIndex(); 
clearOutput(); 

print ("\n *** Staclc Contents *** \n") ; 
for(long i = startindex; i <= endindex ; i++){ 
print ("[ " + i+''] "+ ts.readl(i) >; 

} 

} 

} 

else if( type.compareTo("STACK") == 0){ 

} 

else if( type.coirpareToC'LINKLIST") == 0){ 


} 

else if( type.compareTo("HASH") == 0){ 

TSHash tsHash = (TSHash) agent.getTSObject(agent.TS_HASH, 
if(tsHash != null){ 

"Read["+ frame.txtlD.getText()+"] -> " + tsHash.readlfExists()); 


frame.txtID.getText()), 


print( 
print(' 
print(' 
print(' 
print(' 
print(' 
print(' 


tsHash[a] String -> " + tsHash.getString("a")); 

tsHash[b] Integer -> " + tsHash.getinteger{"b")); 

tsHash[c] Float -> " + tsHash.getFloat("c")); 

tsHash[d] Long _> « + tsHash.getLong("d")); 

tsHash[e] Double -> " + tsHash.getDouble("e")); 

tsHash[f] Boolean -> " + tsHash.getBoolean("f")); 


} 

return true; 


void startEvent(String type) { 

if( type.compareTo("BOOLEAN") == 0) { 

TSBoolean ts = (TSBoolean) 

agent.TS_BOOLEAN,frame.txtlD.getText()); 
if(ts != null){ 

print("Notify["+ frame.txtlD.getText()+"] 

ts.startEvent3(agent,getLeaseTime(),agent.getTransaetion{)) ) ; 
} 

} 

else if( type.compareTo("INTEGER") == 0){ 

TSInteger ts = (TSInteger) 

agent.TS^INTEGER,frame.txtlD.getText()); 
if(ts != null){ 

print("Notify["+ frame.txtlD.getText{)+"] 

ts.startEventS(agent,getLeaseTime(),agent.getTransaction())); 

} 


agent.getTSObject{ 


+ 


agent.getTSObj ect( 


} 

else if( type.compareTo("FLOAT") == 0){ 

TSFloat ts = (TSFloat) agent.getTSObject( agent.TS_FLOAT,frame.txtID.getText()); 
if(ts != null){ 

print("NotifyI"+ frame.txtlD.getText()+"] -> " + 

ts.startEvent3(agent,getLeaseTime(),agent.getTransaction())); 

} 

} 

else if( type.conpareTo("LONG") == 0){ 

TSLong ts = (TSLong) agent.getTSObject{ agent.TS_LONG,frame.txtlD.getText()); 
if(ts != null){ 

print("Notify["+ frame.txtlD.getText()+"] -> " + 

ts.StartEvent3(agent,getLeaseTime(),agent.getTransaetion{))); 

} 

} 

else if( type.compareTo("DOUBLE") == 0){ 
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TSDouble ts = (TSDouble) agent.getTSObject( agent.TS^DOUBLE,frame.txtID.getText()); 
if(ts != null){ 

print(“Notify["+ frame.txtID.getText()+"] -> 

ts.startEvent3(agent,getLeaseTime(),agent.getTransaction())); 

} 

} 

else if( type.compareTo("STRING") == 0){ 

TSString ts = (TSString) agent.getTSObject( agent.TS_STRING,frame.txtID.getText()); 
if(ts != null) 

print(“Notify[“+ frame.txtID.getText()+“] -> 

ts.startEventS(agent,getLeaseTime(),agent.getTransaction())); 
else 

print(“NotifyI“+ frame.txtID.getText()+“] -> Fail"); 


> 

else if( type.compareTo(“QUEUE") == 0){ 

TSQueue ts = (TSQueue) agent.getTSObject( agent.TS^QUEUE,frame.txtID.getText{)); 
if(ts != null){ 

print{"Notify["+ frame.txtID.getText()+"] -> ” 

ts.startEventB(agent,getLeaseTime()/agent.getTransaction())); 

} 

} 

else if( type.compareTo(“STACK") == 0){ 

TSStack ts = (TSStack) agent.getTSObject( agent.TS^STACK,frame.txtID.getText()); 
//if(ts != null){ 

// print(“Notify[“+ frame.txtID.getText()+"] -> 

ts.startEventB(agent,getLeaseTime(),agent.getTransaction{))); 

//} 

} 

else if( type.conpareTo(“LINKLIST") == 0){ 

} 

else if( type.compareTo(“HASH") == 0){ 

TSHash ts = (TSHash) agent .getTSObject ( agent .TS^HASH, frame. txtID.getText ()) ,- 
if{ts != null){ 

print("Notify[“+ frame.txtID.getText()+"] -> 

ts.startEvent3(agent,getLeaseTime(),agent.getTransaction())); 

} 

} 


void stopEvent(String type) { 

if( type.conpareTo(“BOOLEAN") == 0){ 

TSBoolean ts = (TSBoolean) agent.getTSObject( 

agent.TS_BOOLEAN,frame.txtID.getText()); 
if(ts != null){ 

print ("Stop Notification ["+ frame. txtID.getText () + “ ] ->> " + ts. stopEvent {)) ,- 
} if( type.compareTo(“INTEGER") == 0){ 

TSInteger ts = (TSInteger) agent.getTSObject( 

agent.TS_INTEGER,frame.txtID.getText()); 
if(ts != null){ 

print(“Stop Notification["+ frame.txtID.getText()+“] -> " + ts.stopEvent{)); 

} 

else if( type.compareTo(“FLOAT") == 0){ 

TSFloat ts = (TSFloat) agent.getTSObject( agent.TS^FLOAT,frame.txtID.getText()); 
if(ts != null){ 

print(“Stop Notification[“+ frame.txtID.getText()+"] -> " + ts.stopEvent()); 

} 

else if( type.compareTo(“LONG") == 0){ 

TSLong ts = (TSLong) agent.getTSObject( agent.TS_LONG,frame.txtID.getText()); 
if(ts != null){ 

print(“Stop Notification[“+ frame.txtID.getText()+") -> " + ts.stopEvent()); 

} 

else if( type.compareTo("DOUBLE") == 0){ 
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TSDouble ts = (TSDouble) agent.getTSObject( agent.TS_DOUBLE,frame.txtID,getText{)) 
if(ts != null){ 

print ("Stop Notification ["+ frame, txt ID. getText() + " ] -> " + ts. stopEvent () ) ,- 

} 

} 

else if( type.compareTo{"STRING") == 0){ 

TSString ts = (TSString) agent.getTSObject( agent.TS_STRING,frame.txtID.getText()) 
if{ts != null){ 

print("Stop Notification["+ frame.txtID.getText()+"] -> " + ts.stopEvent()); 

} 

} 

else if( type.compareTo("QUEUE") == 0){ 

TSQueue ts = (TSQueue) agent.getTSObject( agent.TS^QUEUE,frame.txtID.getText()); 
if(ts != null){ 

print("Stop Notification["+ frame.txtID.getText()+"] -> " + ts.stopEvent()); 

} 

} 

else if( type.compareTo("STACK") == 0){ 

} 

else if( type.compareTo("LINKLIST") == 0){ 


else if( type .compareTo ("HASH") === 0) { 

TSHash ts = (TSHash) agent.getTSObject( agent.TS_HASH,frame.txtID.getText()); 
if(ts != null){ 

print("Stop Notification["+ frame.txtID.getText()+"] -> " + ts.stopEvent{)); 

} 


} 

} 

public void changeType(String type){ 
refreshListIDs(type); 

if( type.compareTo("BOOLEAN") == 0){ 
frame.txtinput.setText("TRUE"); 

} 

if( type.compareTo("INTEGER") == 0){ 
frame.txtinput.setText("12345"); 

> 

else if( type.compareTo("FLOAT") == 0){ 
frame.txtinput.setText("12345.123456"); 

} 

else if{ type.compareTo("LONG") == 0){ 
frame.txtinput.setText("1234567890"); 

} 

else if( type.coirpareTo{"DOUBLE") == 0) { 

frame.txtinput.setText("1234567890.123456789"); 

} 

else if( type.compareTo("STRING") == 0){ 
frame.txtinput.setText("Hello agent!"); 

} 

else if( type.compareTo("QUEUE") == 0){ 

> 

else if( type.compareTo("STACK") == 0){ 

} 

else if( type.compareTo("LINKLIST") == 0){ 

} 

else if( type.compareTo("HASH") == 0){ 

} 


frame.cmdPut.setEnabled(false); 
frame. cmdUpdate. set Enabled (false) ; 
frame.cmdRead.setEnabled(false); 
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frame.cmdTake.setEnabled(false); 
frame.cmdStartEvent.setEnabled{false); 
frame.cmdStopEvent.setEnabled(false); 
frame.cmdTxnAbort. setEnabled ( false) ; 
frame.cmdTxnClose.setEnabled(false); 
frame.cmdTxnStart.setEnabled(false); 


void IDSelected(int index){ 

frame.txtID.setText{(String) frame.vectorID.get(index)); 

frame.cmdPut-setEnabled(true); 

frame.cmdupdate.setEnabled{true); 

frame.cmdRead.setEnabled(true); 

frame.cmdTake.setEnabled(true); 

frame. cmdStartEvent. setEnabled (true) ; 

frame.cmdStopEvent.setEnabled{true); 

frame -cmdTxnAbort.setEnabled(true); 

frame.cmdTxnClose.setEnabled(true); 

frame.cmdTxnStart.setEnabled(true); 


void refreshAll(){ 

frame.txtSecurityPolicy.setText(agent.getAgentSecurityPolicy()); 
frame.txtSpaceName.setText(agent.getAgentSpaceName()); 
frame.txtCodebase.setText(agent.getAgentServerCodebase()); 
frame.txtLookupGroup.setText(agent.getAgentLookupGroup()); 
frame.txtLookupURL.setText(agent.getAgentLookupURL()); 


void refreshListIDs(String type){ 
int startIndex/ endindex; 
frame.vectorlD.clear(); 

String tirpStr = agent .getTSClassIDs (TSType2lnt (type) ) ; 
if( tmpStr != null ){ 

tmpStr = tmpStr.concat(","); 
startIndex = 0; 

endindex = tmpStr.indexOf(*,‘); 
while(endindex > 0 ){ 

frame.vectorID.add(tmpStr.substring(startindex,endindex)); 

startindex = endindex + 1; 

endindex = tnpStr.indexOf(',',startindex); 

} 

> 

frame.listID.setListData(frame.vectorlD); 

> 

void clearOutput(){ 

frame.vectorOutput.clear(); 

frame.listOutput.setListData(frame.vectorOutput}; 

} 

void printStatus(String str){ 
frame.txtStatus.setText(str); 

//print(str); 

} 

void print(String str){ 

frame.vectorOutput.add(str); 

frame.listOutput.setListData{frame.vectorOutput); 

JScrollBar vbar = frame.listOutputScroll.getVerticalScrollBar(); 
vbar. setValue (vbar. getMaximum ()); 

//System.out .println(str) ; 


long getLeaseTime(){ 

Long tmpLong; 

if(frame.checkLease.isSelected() == true){ 
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time: 


try{ 

//System.out.printIn{" Lease 

Long.decode{frame.txtLease.getText()).longValue()); 

return Long.decode(frame.txtLease.getText()).longValue() ; 

)catch(Exception e){ 
e .printStackTrace(); 

} 

} 

//System.out.println( •’ Lease time:” + Long. MAX_VALIJE) ; 

return Long.MAX_VALUE; 

} 

long getTimeout(){ 

Long tmpLong; 

if(frame.checkLease.isSelected() == true){ 
try{ 

//System, out .print In (" Time Out:" 

Long.decode(frame.txtTimeout.getText(}).longValue()) ; 

return Long.decode(frame.txtTimeout.getText()).longValue() ; 

}catch(Exception e){ 

} 

} 

return Long.MAX_VALUE; 


public void actionPerformed(ActionEvent e) { 

print("... Remote Event Type : [" + TSType2String(e.getID()) + 

e.getActionCommand 0 + "3 "); 

} 

private String TSType2String(int type){ 
switch (type) { 
case 5000: 

return "INTEGER"; 
case 5001: 

return "FLOAT"; 
case 5002: 

return "LONG”; 
case 5003: 

return "DOUBLE"; 
case 5004: 

return "STRING”; 
case 5005: 

return "QUEUE"; 
case 5006: 

return "STACK”; 
case 5007: 

return "LINKLIST"; 
case 5008: 

return "HASH"; 
case 5009: 

return "BOOLEAN"; 
default: 

return "UNKNOWN"; 


} 

} 

private int TSType2Int(String type){ 
if( type-CompareTo("INTEGER") == 0) 
return agent.TS_INTEGER; 
else if( type.coinpareTo( "FLOAT") == 0) 
return agent.TS_FLOAT; 
else if ( type. coxrpareTo (" LONG") == 0) 
return agent.TS_LONG; 
else if( type.compareTo("DOUBLE") == 0) 
return agent.TS_DOUBLE; 
else if( type.conpareTo("STRING") == 0) 
return agent.TS_STRING; 
else if( type.compareTo("QUEUE") == 0) 


"3 ID:(” + 
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return agent.TS_QUEUE; 
else if( type.compareTo{’’STACK") == 0) 
return agent.TS_STACK; 
else if( type.compareToC’LINKLIST") == 0) 
return agent.TS_LINKLIST; 
else if( type.compareTo("HASH") == 0) 
return agent.TS_HASH; 
else if{ type.compareTo("BOOLEAN") == 0) 
return agent.TS_BOOLEAN; 
else 

return 0; 


public void SearchTSClassIDs(){ 
long time; 
int i,j; 
int cc[]; 

cc = new int[500]; 

agent.GreatelD (agent.TS_STRING,"entrylD"); 

for( j = 0; j < 500 ; j++){ 
cc[j] = 0; 

} 

for( j = 0; j < 100 ; j++){ 

time = System. currentTimeMillis 0 ; 
for( i = 0; i < 10 ; i++) 

{ 

TSString ts = (TSString) agent.getTSObject(agent.TS_STRING, "entrylD"); 
if{ts.writel("hello")) 

{ 

if{ ts.takelfExists0.length () > 0) 

{ 

//System, out. print In ( "Latency time -> 

System.currentTimeMillis()); 

} 

} 

} 

int t = (int)((double)(System.currentTimeMillis() - time)/10.0); 

System.out.printIn( "Latency time -> " + t); 

cc[t]++; 

) 

for( j = 0; j < 500 ; j++){ 
if( cc[j] != 0 ){ 

System.out.println( j + " " + cc[j]); 

} 

} 

agent.removelD {agent.TS^STRING, "entrylD") ; 

} 

} 
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B. VISUAL BASIC VERSION 



1. VBTestBench.vb 

Option Explicit 
Private trrp As String 


Private Sub cbType_CIick() 
Select Case cbType.Text 


Case -STRING” 



txtMsg.Text 


-A Sixrple Message" 

Case -INTEGER” 



txtMsg.Text 
Case "FLOAT” 


"1234" 

txtMsg.Text 
Case "LONG" 


"1234-1234" 

txtMsg.Text 
Case "DOUBLE" 

= 

-123456789" 

txtHsg.Text 
Case "BOOLEAN" 


"123455789.1234567S 

txtMsg.Text 

Select 

zz 

"true" 


cindPut .Enabled = False 
crndUpdate.Enabled - False 
ctndKead. Enabled = False 
cmdTake. Enabled == False 
cmdStartNotify. Enabled = False 
endstopNotify.Enabled False 

txnStart.Enabled = False 
txnAbort.Enabled = False 
txnClose.Enabled = False 

Call cmdShowID_Click 
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End Sub 


Private Sub cindClear_Click {) 
ListOutput.Clear 
End Sub 

Private Sub crude 1 ose_C 1 ick () 
'Agent1.TerminateAgent 
Unload Me 
End Sub 


Private Sub cindCreateID_Click () 

dump "Create ID[ " & txtID & ” ] -> " & Agentl .createID{Agentl .getTSType (cbType.Text) , 
txtID) 

Call cmdShowID__Click 

ListID.ListIndex = ListID.ListCount - 1 
emdPut .Enabled = True 
cmdUpdate.Enabled = True 
cmdRead.Enabled = True 
cmdTake.Enabled = True 
cmdStartNotify.Enabled = True 
cmdStopNotify.Enabled = True 
txnStart.Enabled = True 
txnAbort.Enabled = True 
txnClose.Enabled = True 
End Sub 

Private Sub cmdReinitialize_Click() 

Screen.MousePointer = vbHourglass 
If Agentl.InitAgent(5000) Then 
dump "Services Initialized!" 
cmdCreatelD.Enabled = True 
cmdShowID.Enabled = True 
cmdRemovelD. Enabled = True 

Else 

dump "Fail! to initialize services" 
cmdCreateID.Enabled = False 
cmdShowID, Enabled = False 
cmdRemovelD. Enabled = False 
End If 

Screen.MousePointer = vbDefault 
End Sub 

Private Sub cmdRemoveID_Click () 

dump "Remove ID[" & txtID & " ] -> " & Agentl .removelD (Agentl. getTSType (cbType.Text) , 
txtID) 

Call cmdShowID_Click 

ListID.ListIndex = ListID.ListCount - 1 
End Sub 

Private Sub cmdShowID_Click() 

Dim tmp As String, tirpl As String 

tmp = Agentl.getTSClassIDs(Agentl.getTSType(cbType.Text)) 

Dim startPos As Long 
Dim endPos As Long 
tmp = Trim (tmp) & ", " 
startPos = 1 
ListID.Clear 

While startPos < Len(tmp) 

endPos = InStr (startPos, tmp, ", ", vbTextCoirpare) 

If endPos > 0 Then 

tmpl = LTrim(RTrim(Mid(tmp, startPos, endPos - startPos))) 

ListID.AddItern (tmpl) 

End If 

startPos = endPos + 1 


Wend 
End Sub 
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Private Sub cmdPut_Click{) 
Dim writeStr As String 
Dim ret As Boolean 


On Error Resume Next 
writeStr = txtMsg.Text{) 
ret = False 


Select Case cbType.Text 
Case "STRING" 

ret = Agentl.getTSObject(Agentl.getTSType(cbType.Text), 

txtID).write!(writeStr, getLeaseTime(), Agentl.getTransactionO) 

Case "INTEGER" 

ret = Agentl.getTSObject(Agentl.getTSType{CbType.Text), 

txtID).write!(CInt(writeStr), getLeaseTime(), Agentl.getTransaction()) 

Case "FLOAT" 

ret = Agent1.getTSObject(Agentl.getTSType(CbType.Text), 

txtID).write!(CDbl(writeStr), getLeaseTime(), Agentl.getTransaetion()) 

Case "LONG" 

ret = Agentl.getTSObject(Agentl.getTSType(cbType.Text), 

txtID).write!(CLng(writeStr), getLeaseTime(), Agentl.getTransaction()) 

Case "DOUBLE" 

ret = Agentl.getTSObject(Agentl.getTSType(cbType.Text). 

txtID).write!(CDbl(writeStr), getLeaseTime(), Agentl.getTransaction()) 

Case "BOOLEAN" 

ret = Agentl.getTSObject(Agentl.getTSType(CbType.Text). 

txtID).write!(CBool(writeStr), getLeaseTime(), Agentl.getTransaction()) 

End Select 


dump "Write[" & txtID & "] 
End Sub 


->" & writeStr & " : " & ret 


Private Sub cmdUpdate_Click() 

Dim writeStr As String 
Dim ret As Boolean 

On Error Resume Next 
writeStr = txtMsg.Text() 
ret = False 

Select Case cbType.Text 
Case "STRING" 

ret = Agentl. getTSOb j ec t (Agentl. getTSType (cbType. Text) , 

txtID).update!(writeStr, getLeaseTime(), Agentl.getTransaction()) 

Case "INTEGER" 

ret = Agentl.getTSObject(Agentl.getTSType(cbTYpe.Text), 

txtID).update!(CInt(writeStr), getLeaseTime{), Agentl.getTransaction()) 

Case "FLOAT" 

ret = Agentl.getTSObject(Agentl.getTSType(CbType.Text), 

txtID).update!(CDbl(writeStr), getLeaseTime(), Agentl.getTransaction()) 

Case "LONG" 

ret = Agentl.getTSObject(Agentl.getTSType(cbType.Text), 

txtID).update!(CLng(writeStr), getLeaseTime(), Agentl.getTransaction()) 

Case "DOUBLE" 

ret = Agentl.getTSObject (Agentl.getTSType(cbType.Text), 

txtID).update!(CDbl(writeStr), getLeaseTime (), Agentl.getTransaction ()) 

Case "BOOLEAN" 

ret = Agentl.getTSObject{Agentl.getTSType(cbType.Text), 

txtID).update!(CBool(writeStr), getLeaseTime(), Agentl.getTransaction{)) 

End Select 

dxamp "Update [" & txtID & "] ->" & writeStr & " : " & ret 
End Sub 

Private Sub cmdTake_Click() 


123 



dump "Takef" & txtID & ” ] ->" & Agent 1. getTSObject {Agent 1 .getTSType {cbType .Text) , 

txtID).takelfExists2(getTimeOut(), Agentl.getTransaction()) 

End Sub 

Private Sub cmdRead_Click() 

dump ’'Read['' & txtID & "] ->" & Agentl .getTSObject (Agentl. getTSType (cbType .Text) , 

txtID).readIfExiSts2(getTimeOut0, Agentl.getTransaction()) 

End Sub 

Private Sub cmdStartNotify_Click() 

' On Error Resume Next 

dump "Notify ID[ '* & txtID & " ] -> " & 

Agentl.getTSObj ect(Agentl.getTSType(cbType.Text), 

txtID)-startEvent3(Agentl.getActionHandler, getLeaseTime(), Agentl.getTransaction()) 

End Sub 

Private Sub cmdStopNotify_Click() 

On Error Resume Next 

dump "Notify IDE " & txtID & "] -> - & 

Agentl.getTSObject(Agentl.getTSType(cbType.Text), txtID).stopEventO 
End Sub 


' actionPerformed 


Private Sub Agentl_actionPerformed(ByVal ActionEventl As Object) 

dump {"... Remote Event [" & ActionEventl .getActionCoinmand{) & " ] TypeE" & 

ActionEventl.getID() & "]") 

End Sub 


Private Sub dump(str As String) 

ListOutput.Additem (str) 

List Output .List Index = ListOutput. Li stCoiant - 1 
End Sub 


* ************************************************************** 

• Form Methods 

************************************************************* 
Private Sub Forrrt_Load() 

' txtSecurityPolicy = Agentl.getAgentSecurityPolicy 

' txtSpaceName = Agentl.getAgentSpaceName 

* txtLookupGroup = Agentl.getAgentLookupGroup 

’ txtServerCodebase = Agentl.getAgentServerCodebase 

' txtLookupURL = Agentl.getAgentLookupURL 

ListID.Clear 
End Sub 


Private Sub Form_Unload(Cancel As Integer) 
'Agentl,TerminateAgent 
End Sub 

Private Sub ListID_Click() 
txtID = ListID.Text 
cmdPut.Enabled = True 
cmdupdate.Enabled = True 
cmdRead.Enabled = True 
cmdTake-Enabled = True 
cmdStartNotify.Enabled = True 
cmdStopNotify.Enabled = True 
txnStart.Enabled = True 
txnAbort.Enabled = True 
txnClose.Enabled = True 
End Sub 
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' User defined functions 


Private Function getLeaseTime() As Long 
If CheckLease.Value = 1 Then 

getLeaseTime = CLng(TxtLease,Text) 

Else 

getLeaseTime = &HFFFFFFFF 
End If 

End Function 

Private Function getTimeOut() As Long 
If CheckTimeOut.Value = 1 Then 

getTimeOut = CLng(txtTimeOut.Text) 

Else 

getTimeOut = &HFFFFFFFF 
End If 

End Function 


’ Transaction 


Private Sub txnAbort_Click() 

If Agentl.abortTransaction() = False Then 
txntext.Caption = "Error !" 

Else 

txntext-Caption = "Stopped" 

End If 

cmdPut-BackColor = &HC0E0FF 
cmdUpdate.BackColor = &HC0E0FF 
cmdTake.BackColor = ficHCOEOFF 
cmdRead.BackColor = &HC0E0FF 
cmdStartNotify-BackColor = &H8000000F 
cmdStopNotify.BackColor = &H8000000F 
End Sub 

Private Sub txnClose_Click() 

If Agentl-closeTransaction() = False Then 
txntext.Caption = "Error !" 

Else 

txntext.Caption = "Stopped" 

End If 

cmdPut.BackColor = &HC0E0FF 
cmdUpdate.BackColor = &HC0E0FF 
cmdTake.BackColor = &HC0E0FF 
cmdRead.BackColor = &HC0E0FF 
cmdStartNotify.BackColor = &H8000000F 
cmdStopNotify-BackColor = &H8000000F 
End Sub 

Private Sub txnStart_Click() 

If Agentl.startTransaction() = False Then 
cmdPut.BackColor = &HC0E0FF 
cmdUpdate.BackColor = iHCOEOFF 
cmdTake.BackColor = &HC0E0FF 
cmdRead.BackColor = &HC0E0FF 
cmdStartNotify.BackColor = &H8000000F 
cmdStopNotify.BackColor = &H8000000F 
txntext.Caption = "Stopped" 

Else 

cmdPut-BackColor = vbRed 
cmdUpdate.BackColor = vbRed 
cmdTake. Backed or = vbRed 
cmdRead.BackColor = vbRed 
cmdStartNotify.BackColor = vbRed 









cmdStopNotify.BackColor = vbRed 
txntext.Caption = "Running ..." 
End If 
End Sub 
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C. C VERSION 



[o3 : close transaction 
Iql : quit 

[space} : HEKT level 

Enter conimandE tf^pe^SIBIHG IB^ISString 3 —>1 
Enter Object IB —>ISString^ 

^ Level 1 Help ^ 

X X X X ’ M X M X X XX K X K X X K X K KM - X - X XX K - K - X - X M X KX - KK X K X K X K X - X X>^X 

Etl : set object tt^pe 
[i3 : set object IB 
[r] : remove object 
[c2 : create object 
£13 : list all objects 
[s3 : start transaction 
Cal : abort transaction 
Co 3 2 close transaction 
Eq3 : quit 

[space! : HEKT level 

Enter commandE ts?pe:STBING IB:TSString 3 -‘>t 
[03:INTEGER [13:FL0BI E23:LONG [33:BOUBLE E4}:STBIHG 

[53:QUEUE ESlrSIftCK [73:LIHKLISI E83:HBSH E93:BOOLEBN 

Enter Object Type *-> 


1. CtestBench.C 

#include <jni .h> 
tincluce <stddef.h> 
iinclude * agent, 

char levellHelp^void); 
char level2Help{void) ? 

void objTvpe2St:r (int oType^ char^ oTvpeStr); 

int objType; 

char objTypeStr [20]; 

char objXD[20]; 

int tranStartedFlag; 
char processTSString{); 
char processTSInteger(); 
char processTSFIoat(); 
char processTSLong(); 
char processTSBonble(); 
char processTSEoolean(); 

int mainO 

{ 

char ret; 
char bufi255]; 

tranStartedFlag = FALSE; 
initJVKO ; 

if(l initAgentO) goto destroy; 


getAgentSeccrityFolicyCbuf); 

printfC AgentSecurityPolicy -*> %s\n’’,buf); 

getAgentSpaceNarrve(bnf); 

printf(’' AgentSpaceNaste %s\n",buf); 

getAgentServerCodebase(bui); 
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printf(’' Agent Server Codebase %s\n"/buf); 

getAgentLookupGroup(buf); 

printfC AgentLookupGroup -> %s\n’',buf); 

getAgentLookupURL(buf); 

printfC AgentLookupURL -> %s\n%buf); 

if(InitializeAgent(10000) == 1}{ 

GreateID(TS_STRING,"EntrylD”); 
objType = 5004; 

objType2Str(objType,objTypeStr); 
sprintf(objID,"EntrylD") ; 

while(ret != 'q') 

{ 


ret = levellHelp(); 
if( ret == ' ') 

{ 

ret = level2Help(); 

} 


} 


} 


destroy: 

if { (*env) *->ExceptionOccurred{env) ) 
(*env) -’>ExceptionDescribe (env) ; 


{*jvin) ->DestroyJavaVM( jvm) ; 
return 0; 


char levellHelp(void) 

{ 

while(1) 

{ 

char inputChar[20]; 
char inputStr[20]; 

printf("\n\t***********************************************\n") ; 

printf("\t** Level 1 Help **\n‘'); 

printf(”\t***********************************************\n"); 

printf("\t[t] : set object type Xn"); 

printf("\t[i] ; set object ID\n"); 

printf("\t[r] : remove objectXn”); 

printf (•'Xt [c] : create objectXn”); 

printf("Xt[1] : list all objectsXn"); 

//printf("Xt[e] : clean object entriesXn"); 
printf (" Xt [s] : start transactionXn'*); 
printf("Xt[a] : abort transactionXn"); 
printf("Xt[o] : close transactionXn"); 
printf("Xt[q] : quitXn"); 
printf (’'Xt[ space] : NEXT level XnXn"); 
if(tranStartedFlag) 

printf("XtTRANSACTION : Enter command[ type:%s ID:%s ] 

,objTypeStr, objID); 

else 

printf("XtEnter command[ type:%s ID:%s ] ->",objTypestr, objID); 

gets(inputChar); 
switch(inputChar[0]) 

{ 

case 'Q’: 
case 'q*: 

return 'q'; 
case ' ’: 

return ’ '; 
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case 't': 


printf{"\t[0] :INTEGER [1] :FLOAT [2]:L0NG [3]:D0UBLE 

[4]:STRING\n"); 

printf("\t[5]:QUEUE [6]:STACK [7]:LINKLIST [8]:HASH 

[9]:BOOLEAN\n"); 

printf("\tEnter Object Type 
gets(inputStr); 

objType = 5000+atoi(inputStr); 
objType2Str{objType,objTypestr); 
break; 
case 'i’: 

printf("\tEnter Object ID 
gets(objID); 
break; 
case 'r': 

printf {'*\n##Result## -> Remove %s[%s] %s\n'’, objID, 

objTypeStr, (removelD (objType, obj ID) == 0 ? "Fail!" : "Ok!")); 

break; 
case *c': 

printf("\n##Result## -> Create %s[%s] %s\n",objID, 

objTypeStr, (createlD(objType,objID) == 0 ? "Fail!" : "Ok!")); 

break; 
case '1': 

break; 
case 'e': 

cleanTSClass(objType,objID); 
break; 
case 's': 

tranStartedFlag = startTransaction(); 

printf("\n##Result## -> Start Transaction -> %s", 

tranStartedFlag == TRUE ? "Ok!" : "Fail!"); 

break; 
case 'a': 

tranStartedFlag = FALSE; 

printf("\n##Result## -> Abort Transaction -> %s", 

abortTransactionO == TRUE ? "Ok!" : "Fail!"); 

break; 
case 'o': 

tranStartedFlag = FALSE; 

printf{"\n##Result## -> Close Transaction -> %s", 

closeTransactionO == TRUE ? "Ok!" : "Fail!"); 

break; 


char level2Help(void) 

{ 

char ret = '!'; 
while(ret != ' ') 
{ 


%s 3 


objID); 

switch (objType) 

{ 
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printf(•\n\t****»»******»******’***************************Nn”); 

printf("\t** Level 2 Help **\n"); 

printf("\t***********************"'***********************\n"); 

printf ("\t[w] : write entryXn"); 

printf("\t[u] : update entryXn"); 

printf("\t[r3 : read entry\n"); 

printf("\t[t] : take entryXn"); 

printf("\t[space] : PREVIOUS level \n"); 

if(tranStartedFlag) 

printf("\tTRANSACTION : Enter command[ type:%s ID: 

>",obj TypeStr, objID); 

else 

printf("\tEnter command! type:%s ID:%s ] ~>",objTypeStr, 



} 


case TS^INTEGER : 

ret = processTSInteger{) ; 
break; 

case TS_FLOAT : 

ret = processTSFloat{); 
break; 

case TS_LONG ; 

ret = processTSLong() ; 
break; 

case TS_DOUBLE : 

ret = processTSDouble0; 
break; 

case TS_STRING : 

ret = processTSString(); 
break; 

case TS_QUEUE : 
break; 

case TS_STACK : 
break; 

case TS_LINKLIST : 
break; 

case TS_HASH : 
break; 

case TS_BOOLEAN ; 

ret = processTSBoolean(); 
break; 

default: 

break; 


} 

return ret; 


char processTSString() 

{ 

char inputChar[20]; 
char inputstr[20]; 
char outputStr[255]; 
int ret; 

gets(inputChar); 
switch{inputChar[0]) 
{ 


case 'w': 

printf ("NtEnter String ->'*); 
gets (inputStr) ; 
if(tranStartedFlag) 

ret = TSStringTransWrite(objID,inputStr,100000); 

else 

ret = TSStringWritel(objID,inputStr); 
printf("\n##Result## -> Write %s[%s] %s : %s\n",objID, 

objTypeStr, inputStr, ret == TRUE ? "Ok!" : ’•Fail!”); 
break; 
case 'u': 

printf(”\tEnter String ->"); 
gets(inputStr); 
if(tranStartedFlag) 

ret = TSStringTransUpdate(objID,inputStr,100000); 

else 

ret = TSStringUpdatel(objID,inputStr); 
printf("\n##Result## -> Update %s[%s] %s : %s\n",objID, 

objTypeStr,inputStr, ret == TRUE ? "Ok!” : "Fail!"); 
break; 
case 'r': 

if(tranStartedFlag) 

TSStringTransRead(objID,outputStr,100000); 

else 
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TSStringReadl(objID,outputStr); 
printf(”\n##Result## -> Read %s[%s] 

objTypestr,outputStr); 

break; 
case 't': 

if(tranStartedFlag) 

TSStringTransTake{objID,outputStr, 100000) ; 

else 

TSStringTakel(objID,outputStr); 
printf("\n##Result## -> Take %s[%s] 

objTypestr,outputStr); 

break; 
case ’ ': 

return ' '; 


%s\n",objID, 


%s\n'’, objID, 


} 

return '!’; 


} 


char processTSInteger{) 

{ 

char inputChar[20]; 
char inputStr[20]; 
int ret, value; 
gets(inputChar); 
switch(inputChar[0]) 

{ 

case 'W : 

printf(“XtEnter Integer value “>”); 
value = atoi(gets(inputStr)); 
if(tranStartedFlag) 

ret = TSIntegerTransWrite(objID,value, 100000); 

else 

ret = TSIntegerWriteKobjID/Value); 
printf (''\n##Result## “> Write %s[%s] %d : %s\n", objID, 

objTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'u': 

printf("NtEnter Integer ->"); 
value = atoi(gets(inputStr)); 
if(tranStartedFlag) 

ret = TSIntegerTransUpdate(objID,value,100000); 

else 

ret = TSIntegerUpdatel(objID,value); 
printf("\n##Result## -> Update %s[%s] %d : %s\n",objID, 

objTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'r': 

if(tranStartedFlag) 

value = TSIntegerTransRead(objID,100000); 

else 

value = TSIntegerReadl(objID); 

printf("\n##Result## -> Read %s[%s] %d\n",objID, 

ObjTypeStr,value) ; 

break; 
case 't': 

if(tranStartedFlag) 

value = TSIntegerTransTake(objID,100000); 

else 

value = TSIntegerTakel(objID); 

printf("\n##Result## -> Take %s[%s] %d\n",objID, 

ObjTypeStr,value); 

break; 
case ' ': 

return ' '; 
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> 

return '!'; 


char processTSFloat() 

{ 

char inputChar[20]; 
char inputstr[20]; 
int ret; 
float valued- 
gets (inputChar); 
switch(inputChar[0]) 
{ 


case 'w’ : 

printf("NtEnter Float value 
//value = (float) atof(gets(inputStr)); 
scanf("%f"dvalue); 
if(tranStartedFlag) 

ret = TSFloatTransWrite(objIDdvalue, 100000); 

else 

ret = TSFloatWritel(objIDdvalue); 

printf ("\n##Result## -> Write %s[%s] %f : %s\n'’, objlD, 

ObjTypeStr,valued ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'u’: 

printf("\tEnter Float ->"); 

value = (float) atof(gets(inputstr)); 

if(tranStartedFlag) 

ret = TSFloatTransUpdate(objIDdvalue, 100000) ; 

else 

ret = TSFloatUpdatel(objIDdvalue); 
printf("\n##Result## -> Update %s[%s] %f : %s\n"dObjIDd 

objTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'r’; 

if(tranStartedFlag) 

value = TSFloatTransRead(objID,100000) ; 

else 

value = TSFloatReadl(objID); 

printf("\n##Result## -> Read %s[%s] %f\n",objIDd 

objTypeStr,value) ; 

break; 
case 't': 

if(tranStartedFlag) 

value = TSFloatTransTake(objlDdlOOOOO) ; 

else 

value = TSFloatTakel(objID); 

printf("\n##Result## -> Take %s[%s] %f\n"dobjID, 

ObjTypeStr,value) ; 

break; 
case ' ': 

return ‘ '; 

} 

return ’!*; , 


} 


char processTSLong() 

{ 

char inputChar[20]; 
char inputstr[20]; 
int retd- 
long value; 
gets(inputChar); 
switch(inputChar[0]) 
{ 
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case 'w': 

printf("NtEnter Long value 
value = atol(gets(inputStr)); 
if(tranStartedFlag) 

ret = TSLongTr an sWrite(objID,value/100000); 

else 

ret = TSLongWritel(objID,value); 

printf("\n##Result## -> Write %s[%s] %d : %s\n",objID, 

objTypeStr,value, ret == TRUE ? "Ok!” : "Fail!"); 
break; 
case ‘u': 

printf{"NtEnter Long ->"); 
value = atol(gets(inputStr)); 
if(tranStartedFlag) 

ret = TSLongTransUpdate(objID,value,100000); 

else 

ret = TSLongUpdatel(objID,value); 

printf("\n##Result## -> Update %s[%s] %d : %s\n",objID, 

objTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case ’r': 

if(tranStartedFlag) 

value = TSLongTransRead(objID,100000); 

else 

value = TSLongReadl(objlD); 

printf("\n##Result## -> Read %s[%s] %d\n",objID, 

objTypeStr,value) ; 

break; 
case 't': 

if(tranStartedFlag) 

value = TSLongTransTake(objID,100000); 

else 

value = TSLongTakel(objlD); 

printf("\n##Result## -> Take %s[%s) %d\n",objID, 

ObjTypeStr,value) ; 

break; 
case ’ ': 

return ' '; 

} 

return '!'; 


char processTSDouble() 

{ 

char inputChar[20]; 
char inputStr[20]; 
int ret; 
double value; 
gets (inputChar) ,- 
switch(inputChar[0]) 
{ 


case 'w': 

printf("NtEnter Double value ->"); 
value = atof(gets(inputStr)); 
if(tranStartedFlag) 

ret = TSDoubleTransWrite(objID,value,100000); 

else 

ret = TSDoubleWritel{objID,value); 

printf("Nn##Result## -> Write %s[%s] %f : %sNn",objID, 

ObjTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'u*: 

printf{"NtEnter Double ->"); 
value = atof(gets(inputStr)); 
if(tranStartedFlag) 
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ret = TSDoubleTransUpdate(objID,value,100000); 

else 

ret = TSDoubleUpdatel(objID,value); 
printf ('•\n##Result## -> Update %s[%s] %f : %s\n‘',objID, 

objTypeStrevalue, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'r': 

if(tranStartedFlag) 

value = TSDoubleTransRead(objID, 100000); 

else 

value = TSDoubleReadl(objID); 

printf("\n##Result## -> Read %s[%s] %f\n",objID, 

objTypeStr,value); 

break; 
case 't’: 

if(tranStartedFlag) 

value = TSDoubleTransTake(objID,100000); 

else 

value =: TSDoubleTakel(objlD); 

printf("\n##Result## -> Take %s[%s] %f\n",objID, 

objTypeStr,value); 

break; 
case ' *: 

return ’ '; 


} 

return '!'; 


char processTSBoolean() 

{ 

char inputChar[203; 
char inputStr[20]; 
int ret, value; 
gets(inputChar); 
switch(inputChar[0]) 
{ 


case 'w‘: 

printf("\tEnter Boolean value ->"); 
value = atoi (gets (inputStr)) ,- 
if(tranStartedFlag) 

ret = TSBooleanTransWrite(obj ID, value, 100000); 

else 

ret = TSBooleanWritel(objID,value); 
printf("\n##Result## -> Write %s[%s3 %d : %s\n",objID, 

objTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'u': 

printf ("\tEnter Boolean ->") ,- 
value = atoi(gets(inputStr)); 
if(tranStartedFlag) 

ret = TSBooleanTransUpdate(objID,value,100000); 

else 

ret = TSBooleanUpdatel(objID,value); 
printf{"\n##Result## -> Update %s[%s] %d : %s\n",objID, 

ObjTypeStr,value, ret == TRUE ? "Ok!" : "Fail!"); 
break; 
case 'r': 

if(tranStartedFlag) 

value = TSBooleanTransRead(objID,100000); 

else 

value = TSBooleanReadl(objID); 

printf{"\n##Result## -> Read %s[%s] %d\n",objID, 

obj Type Str, value) ; 

break; 
case 't': 

if(tranStartedFlag) 
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value = TSBooleanTransTake(objID, 100000) ,* 

else 

value = TSBooleanTakel{objID); 

printf("\n##Result## -> Take %s[%s] %d\n",objID, 

objTypeStr,value) 

break; 
case ' ': 

return ’ '; 

} 

return *!*; 


void objType2Str(int oType, char* oTypeStr) 

{ 

switch (oType) 

{ 

case TS_INTEGER : 

sprintf(OTypeStr, "INTEGER"); 
break; 

case TS_FLOAT : 

sprintf(oTypeStr, "FLOAT"); 
break; 

case TS_LONG : 

sprintf(oTypeStr, "LONG"); 
break; 

case TS_DOUBLE : 

sprintf(oTypeStr, "DOUBLE"); 
break; 

case TS_STRING : 

sprintf(oTypeStr, "STRING"); 
break; 

case TS_QUEUE : 

sprintf(oTypeStr, "QUEUE"); 
break; 

case TS_STACK : 

sprintf(OTypeStr, "STACK"); 
break; 

case TS^LINKLIST : 

sprintf(OTypeStr, "LINKLIST"); 
break; 

case TS__HASH : 

sprintf(OTypeStr, "HASH"); 
break; 

case TSJOOLEAN : 

sprintf (oTypeStr, "BOOLEAN") ; 
break; 

default: 

sprintf(OTypeStr, "STRING"); 
break; 

} 

} 
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APPENDIX D. AGENT WRAPPER LISTING 


1. AGENT.H 

#ifndef _AGENT_H_ 

#define _AGENT_H_ 

#define PATH_SEPARATOR /* define it to be on Solaris */ 

//#define USER_CLASSPATH “d:/Tuplespace/Jni/Invoke/Debug/*' /* where Prog.class is 
#define USER„CLASSPATH /* where Prog.class is */ 

#define TRUE 1 
#define FALSE 0 

#define TS_INTEGER 5000 
#define TS^FLOAT 5001 
#define TS_LONG 5002 
#define TS_DOUBLE 5003 
#define TS^STRING 5004 
tdefine TS^QUEUE 5005 
tdefine TS_STACK 5006 
tdefine TS_LINKLIST 5007 
tdefine TS^HASH 5008 
tdefine TS_BOOLEAN 5009 


//***************★************************************** 

Z/***************************************************-^** 

// Global Variables 

//****★*****■*★****★*******************★★**************** 

JavaVM *jvin; 

JNIEnv *env; 

jclass agentClass; if Agent class; 

jobject agentObject; If Agent object; 

jmethodlD jInitializeAgent,jTerminateAgent; 

// Java space parameters methods 

jmethodlD jSetAgentSecurityPolicy/jGetAgentSecurityPolicy; 
jmethodlD jSetAgentSpaceName, j Get Agent SpaceName; 
jmethodlD j SetAgentServerCodebase,jGetAgentServerCodebase; 
jmethodlD j SetAgentLookupGroup,j GetAgentLookupGroup; 
jmethodlD j SetAgentLookupURL,j GetAgentLookupURL; 

// Tuple methods 

jmethodlD jCreateID,jRemovelD,jCleanTSClass,jGetTSObject; 

jmethodlD jStartTransaction, jGetTransaction, jlsTransactionStarted; 

jmethodlD jAbortTransaction, jCloseTransaction, jUpdateTransactionHandle; 

// TSInteger 

jmethodlD j TSIntegerWritel,j TSIntegerWrite2,j TSIntegerUpdatel,j TSIntegerUpdate2; 
jmethodlD jTSIntegerReadl,jTSIntegerRead2,jTSIntegerTakel,jTSIntegerTake2; 
jmethodlD 

jTSIntegerTransWrite, jTSIntegerTransUpdate, jTSIntegerTransRead, jTSIntegerTransTake; 

// TSFloat 

jmethodlD jTSFloatWritel,jTSFloatWrite2,jTSFloatUpdatel,jTSFloatUpdate2; 
jmethodlD jTSFloatReadl,jTSFloatRead2,jTSFloatTakel,jTSFloatTake2; 

jmethodlD jTSFloatTransWrite,jTSFloatTransUpdate,jTSFloatTransRead,jTSFloatTransTake; 

// TSLong 

jmethodlD jTSLongWritel,jTSLongWrite2,jTSLongUpdatel,jTSLongUpdate2; 
jmethodlD jTSLongReadl,jTSLongRead2,jTSLongTakel,jTSLongTake2; 

jmethodlD jTSLongTransWrite, jTSLongTransUpdate, jTSLongTransRead, jTSLongTransTake; 

// TSDouble 

jmethodlD jTSDoubleWri tel, jTSDoubleWrite2, jTSDoubleUpdatel, jTSDoubleUpdate2 ; 
jmethodlD jTSDoubleReadl, jTSDoubleRead2, jTSDoubleTakel, jTSDoubleTake2 ; 

jmethodlD jTSDoubleTransWrite, jTSDoubleTransUpdate, jTSDoubleTransRead, jTSDoubleTransTake 
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// TSString 

jmethodlD jTSStringWritel,jTSStringWrite2,jTSStringUpdatel,jTSStringUpdate2; 
jmethodID jTSStringReadl,jTSStringRead2,jTSStringTakel,jTSStringTake2; 

jmethodlD jTSStringTransWriteo'TSStringTransUpdate,jTSStringTransRead,jTSStringTransTake; 
// TSHash 

jmethodlD jTSHashWritel,jTSHashWrite2,jTSHashUpdatel,jTSHashUpdate2; 

jmethodlD jTSHashReadl,jTSHashRead2,jTSHashTakel,jTSHashTake2; 

jmethodlD jTSHashTransWrite, jTSHashTransUpdateoTSHashTransRead, jTSHashTransTake; 

// TSBoolean 

jmethodlD jTSBooleanWritel,jTSBooleanWrite2,jTSBooleanUpdatel, jTSBooleaiiUpdate2; 
jmethodlD jTSBooleanReadl,jTSBooleanRead2,jTSBooleanTakel,jTSBooleanTake2; 
jmethodlD 

jTSBooleanTransWrite, jTSBooleanTransUpdateoTSBooleanTransRead, jTSBooleanTransTake; 


//★★*************************************************** 

// Agent setting 

//****★********.*************************★*************** 

void initJVM(void) ; 

int initAgent (void); 

int initMethods (void) ; 

void logError(char* str); 

// Java space parameters methods 
void setAgentSecurityPolicy(char* buf); 
void getAgentSecurityPolicy(char* buf); 
void setAgentSpaceName (char* buf) ; 
void getAgentSpaceName(char* buf); 
void setAgentServerCodebase(char* buf); 
void getAgentServerCodebase(char* buf); 
void setAgentLookupGroup(char* buf); 
void getAgentLookupGroup(char* buf); 
void setAgentLookupURL(char* buf); 
void getAgentLookupURL(char* buf); 

int createlD(int classType, char* objectID); 

int removeID(int classType, char* objectID); 

int cleanTSClass(int classType, char* objectID); 

jobject getTSObject(int classType, char* objectID); 

int startTransaction(); 

j obj ect getTransaction(); 

int isTransactionStarted(); 

int abortTransaction(); 

int closeTransaction(); 

int updateTransactionHandle(int classType, char* objectID); 


// TSInteger 

int TSIntegerWritel( char* objectID,int value); 

int TSIntegerWrite2( char* objectID,int value, long lease); 

int TSIntegerUpdatel( char* objectID,int value); 

int TSIntegerUpdate2( char* objectID,int value, long lease); 

int TSIntegerReadl ( char* objectID) ,- 

int TSIntegerRead2 ( char* objectID, long timeout); 

int TSIntegerTakel( char* objectID); 

int TSIntegerTake2( char* objectID, long timeout); 

int TSIntegerTransWrite( char* objectID,int value, long lease); 

int TSIntegerTransUpdate( char* objectID,int value, long lease); 

int TSIntegerTransRead( char* objectID, long timeout); 

int TSIntegerTransTake( char* objectID, long timeout); 

// TSFloat 

int TSFloatWritel( char* objectID,float value); 

int TSFloatWrite2( char* objectID,float value, long lease); 

int TSFloatUpdatel ( char* objectID, float value) ,- 

int TSFloatUpdate2( char* objectID,float value, long lease); 
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float TSFloatReadl( char* objectlD); 

float TSFloatRead2( char* objectlD, long timeout); 

float TSFloatTakel( char* objectlD); 

float TSFloatTake2( char* objectlD, long timeout); 

int TSFloatTransWrite( char* objectlD,float value, long lease); 

int TSFloatTransUpdate{ char* objectlD,float value, long lease); 

float TSFloatTransRead{ char* objectlD, long timeout); 

float TSFloatTransTake( char* objectlD, long timeout); 

// TSLong 

int TSLongWritel( char* objectlD,long value); 

int TSLongWrite2( char* objectlD,long value, long lease); 

int TSLongUpdatel{ char* objectlD,long value); 

int TSLongUpdate2( char* objectlD,long value, long lease); 

long TSLongReadl( char* objectlD); 

long TSLongRead2( char* objectlD, long timeout); 

long TSLongTakel( char* objectlD); 

long TSLongTake2( char* objectlD, long timeout); 

int TSLongTransWrite( char* objectlD,long value, long lease); 

int TSLongTransUpdate{ char* objectlD,long value, long lease); 

long TSLongTransRead( char* objectlD, long timeout); 

long TSLongTransTake( char* objectlD, long timeout); 

II TSDouble 

int TSDoubleWritel( char* objectlD,double value); 

int TSDoubleWrite2( char* objectlD,double value, long lease); 

int TSDoubleUpdatel( char* objectlD,double value); 

int TSDoubleUpdate2( char* objectlD,double value, long lease); 

double TSDoubleReadl( char* objectlD); 

double TSDoubleRead2( char* objectlD, long timeout); 

double TSDoubleTakel( char* objectlD); 

double TSDoubleTake2< char* objectlD, long timeout); 

int TSDoubleTransWrite( char* objectlD,double value, long lease); 

int TSDoubleTransUpdate( char* objectlD,double value, long lease) 

double TSDoubleTransRead( char* objectlD, long timeout); 

double TSDoxibleTransTake ( char* objectlD, long timeout); 

// TSBoolean 

int TSBooleanWritel( char* objectlD,int value); 

int TSBooleanWrite2( char* objectlD,int value, long lease); 

int TSBooleanUpdatel( char* objectlD,int value); 

int TSBooleanUpdate2( char* objectlD,int value, long lease); 

int TSBooleanReadl( char* objectlD); 

int TSBooleanRead2( char* objectlD, long timeout); 

int TSBooleanTakel ( char* objectlD) ,- 

int TSBooleanTake2( char* objectlD, long timeout); 

int TSBooleanTransWrite( char* objectlD,int value, long lease); 

int TSBooleanTransUpdate{ char* objectlD,int value, long lease); 

int TSBooleanTransRead{ char* objectlD, long timeout); 

int TSBooleanTransTake( char* objectlD, long timeout); 

// TSHash 

int TSHashWritel( char* objectlD); 

int TSHashWrite2( char* objectlD, long lease); 

int TSHashUpdatel( char* objectlD); 

int TSHashUpdate2{ char* objectlD, long lease); 

int TSHashReadK char* objectlD); 

int TSHashRead2( char* objectlD, long timeout); 

int TSHashTakeK char* objectlD); 

int TSHashTake2{ char* objectlD, long timeout); 

int TSHashTransWrite( char* objectlD, long lease); 

int TSHashTransUpdate( char* objectlD, long lease); 

int TSHashTransRead( char* objectlD, long timeout); 

int TSHashTransTake( char* objectlD, long timeout); 


//TSString 

int TSStringWritel( char* objectlD,char* inputstr); 

int TSStringWrite2( char* objectlD,char* inputStr, long lease); 
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int TSStringUpdatel( char* objectID,char* inputStr); 

int TSStringUpdate2( char* objectID,char* inputStr, long lease); 

void TSStringReadl( char* objectID,char* outputBuf); 

void TSStringRead2( char* objectID,char* outputBuf, long timeout); 

void TSStringTakel( char* objectID,char* outputBuf); 

void TSStringTake2( char* objectID,char* outputBuf, long timeout); 

int TSStringTransWrite( char* objectID,char* inputStr, long lease); 

int TSStringTransUpdate( char* objectID,char* inputStr, long lease); 

void TSStringTransRead( char* objectID,char* outputBuf, long timeout); 

void TSStringTransTake( char* objectID,char* outputBuf, long timeout); 

#endif /* _AGENT_H_ */ 
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2 , 


AGENT.C 

#include <jni.h> 
tinclude <stddef.h> 
#include "agent.h" 


//***************************************************************** 
// Initialize Java Virtual Machine 
//***************************************************************** 
void initJVM(void) 

{ 

JavaVMInitArgs vm_args; 

JavaVMOption options[13; 
jint jvmStatus; 

//- 

// Initialize JVM 

options[0].optionstring = "-Djava.class.path=" USER^CLASSPATH; 
vnuargs.version = 0x00010002; 
vm_args.options = options; 
vin_args.nOptions = 1; 

vm^args . ignoreUnrecognized = JNI_TRUE; 

jvmStatus = JNI_CreateJavaVM{&jvm, (void**)&env, &vm_args) ; 
if (jvmStatus < 0) 

{ 

fprintf(stderr, "Can't create Java VM\n"); 
exit{0}; 

} 

-- 

} 

//**★************************************************************** 
// Initialize Agent 

j /*******★********************************************************* 

int initAgent(void) 

{ 


//- 

// Initialize Java Class 
jmethodID constructor; 

agentClass = (*env)->FindClass(env, "tuplespace.core.Agent"); 
if (agentClass == 0) 

return FALSE; 

constructor = (*env)->GetMethodID(env, agentClass, "<init>","()V"); 
agentObject = (*env) ~>NewObject (env, agentClass, constructor) ; 
if (agentObject == 0) 
return FALSE; 

logError("init Agent 01c'\n"); 

if(I initMethods()) 
return FALSE; 

return TRUE; 

//- 


int initMethods (void) 

{ 

jclass tsClass; 

//- 

// Get method handles of Java Program 

jInitializeAgent = (*env)->GetMethodID(env, agentClass, "InitAgent", "(J)Z"); 
jTerminateAgent = (*env)>>GetMethodID(env, agentClass, "TerminateAgent", "OV" 
if (!jInitializeAgent 1| !jTerminateAgent) return FALSE; 
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agentClass, 


jSetAgentSecurityPolicy = (*env)“>GetMethodID(env, 

"setAgentSecurityPolicy", "(Ljava/lang/String;)V”}; 

jGetAgentSecurityPolicy = {*env) ->GetMethodID(env, agentClass, 

"getAgentSecurityPolicy", "{)Ljava/lang/String;"); 

if ('jGetAgentSecurityPolicy || !jSetAgentSecurityPolicy) return FALSE; 

jSetAgentSpaceName = {*env)->GetMethodID(env, agentClass, "setAgentSpaceName”, 
•' (Ljava/lang/String;) V") ; 

jGetAgentSpaceName = (*env)->GetMethodID(env, agentClass, "getAgentSpaceName", 
" {)Ljava/lang/String;"); 

if {! jGet Agent SpaceName || ! jSetAgentSpaceName) retumFALSE; 

jSetAgentServerCodebase = (*env)~>GetMethodID(env, agentClass, 

"setAgentServerCodebase", "(Ljava/lang/String;) V”); 

jGetAgentServerCodebase = (*env)->GetMethodID(env, agentClass, 

"getAgentServerCodebase", "()Ljava/lang/String;"); 

if (!jGetAgentServerCodebase || !jSetAgentServerCodebase) return FALSE; 

jSetAgentLookupGroup = (*env)>>GetMethodID(env, agentClass, "setAgentLookupGroup", 
" (Ljava/lang/String; )V’') ; 

jGetAgentLookupGroup = (*env)->GetMethodID(env, agentClass, "getAgentLookupGroup", 
"()Ljava/lang/String;”); 

if (!jGetAgentLookupGroup |1 !jSetAgentLookupGroup) return FALSE; 

jSetAgentLookupURL = (*env)->GetMetliodID(env, agentClass, "setAgentLookupURL", 
*(Ljava/lang/String;)V"); 

jGetAgentLookupURL = (*env)->GetMethodID(env, agentClass, "getAgentLookupURL", 
" ()Ljava/lang/String;") ; 

if (!jGetAgentLookupURL || !jSetAgentLookupURL) return FALSE; 

jStartTransaction = (*env)-■>GetMethodID(env, agentClass, "startTransaction", 

" OZ") ; 

jGetTransaction = (*env)->GetMethodID(env, agentClass, "getTransaetion", 

"()Lnet/jini/core/transaction/Transaction;"); 

jlsTransactionStarted = (*env)->GetMethodID(env, agentClass, 

"isTransactionStarted", "()Z”); 

jAbortTransaction = (*env)->GetMethodID(env, agentClass, "abortTransaetion", 

"()Z")7 

jCloseTransaction = (*env)->GetMethodID(env, agentClass, "closeTransaction", 

" OZ"); 

jUpdateTransactionHandle = {*env)~>GetMethodID(env, agentClass, 

"updateTransaetionHandle", "(ILjava/lang/String;)Z"); 

if (! jStartTransaction || !jGetAgentLookupURL || !jIsTransactionStarted || 

lupdateTr ansae tionHandle 

II .'jAbortTransaction || '.jCloseTransaction) return FALSE; 


jCreatelD = 

•' (ILjava/lang/String;) Z") ; 
jRemoveID 

^ (ILjava/lang/String; )Z''); 

jCleanTSClass = 

"(ILjava/lang/String;)Z"); 

jGetTSObject = (*env)->GetMethodID (env, 

"(ILjava/lang/string;)Ljava/lang/Object;"); 

if (ijCreatelD || ijRemovelD || !jCleanTSClass || 


(*env)->GetMethodID(env, 
(*env) ->GetMethodID (env, 
(*env) ->GetMethodID (env, 


agentClass, 

agentClass, 

agentClass, 

agentClass, 

! jGetTSObject) 


"createlD", 
"removelD", 
"cleanTSClass'’, 
"getTSObject", 
return FALSE; 


// TSInteger 

tsClass = (*env) ■'>FindClass (env, "tuplespace.core.TSInteger") ; 
jTSIntegerWritel = (*env)->GetMethodID(env, tsClass, "writel", "(I)Z"); 
jTSIntegerWrite2 = (*env)->GetMethodID(env, tsClass, ’'write2'’, "(IJ)Z"); 
jTSIntegerUpdatel = (*env)->GetMethodID(env, tsClass, "updatel", "(DZ"); 
jTSIntegerUpdate2 = (*env) “>GetMethodID(env, tsClass, "update2", "(IJ)Z’*); 
jTSIntegerReadl = (*env)->GetMethodID(env, tsClass, "readlfExists", "OI”); 
jTSIntegerRead2 = (*env)->GetMethodID(env, tsClass, "readlfExistsl", "(J)!"); 
jTSIntegerTakel = (*env)->GetMethodID(env, tsClass, "takeIfExists”, "()!"); 
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jTSIntegerTake2 = (*env)->GetMethodID(env, tsClass, "takelfExistsl", "(J)I"); 
jTSIntegerTransWrite = {*env)->GetMethodID{env, tsClass, "transWrite", "(IJ)Z"); 
jTSIntegerTransUpdate = (*env}->GetMethodID (env, tsClass, " transUpdate", "(IJ)Z’'); 
jTSIntegerTransRead = (*env)~>GetMethodID(env/ tsClass, "transRead", "(J)!"); 
jTSIntegerTransTake = (*env) *->GetMethodID(enVr tsClass, '• transTake", "(J)!"); 

if (!jTSIntegerWritel i| !jTSIntegerWrite2 || !jTSIntegerUpdatel || 

jTSIntegerUpdate2 || 

!jTSIntegerReadl || !jTSIntegerRead2 ||ijTSIntegerTakel || 

jTSIntegerTake2 || 

•jTSIntegerTransWrite || !jTSIntegerTransUpdate || 1jTSIntegerTransRead || 

jTSIntegerTransTake) 

return FALSE; 

// TSFloat 

tsClass = (*env)->FindClass(env, "tuplespace.core.TSFloat"); 
jTSFloatWritel = (*env)->GetMethodID(env, tsClass, "writel", ”(F)Z"); 
jTSFloatWrite2 = (*env)->GetMethodID(env, tsClass, "write2", "(FJ)Z”); 
jTSFloatUpdatel = {*env) ~>GetMethodID(env, tsClass, "updatel", "(F)Z’'); 
jTSFloatUpdate2 = (*env)->GetMethodID{env, tsClass, "update2", ''(FJ)Z”); 
jTSFloatReadl = (*env)->GetMethodID(env, tsClass, "readlfExists", "OF"); 
jTSFloatRead2 = (*env)~>GetMethodID(env, tsClass, "readlfExistsl", "(J}F"); 
jTSFloatTakel = (*env)->GetMethodlD(env, tsClass, "takelfExists", "OF"); 
jTSFloatTake2 = (*env)->GetMethodID(env, tsClass, "takelfExistsl", "(J)F"); 
jTSFloatTransWrite = (*env)->GetMethodID(env, tsClass, "transWrite", "(FJ)Z"); 
jTSFloatTransUpdate = (*env)->GetMethodID(env, tsClass, "transUpdate", "(FJ)Z"); 
jTSFloatTransRead = (*env)->GetMethodID(env, tsClass, "transRead", "(J)F"); 
jTSFloatTransTake = (*env)->GetMethodID(env, tsClass, "transTake", "(J)F"); 

if (•jTSFloatWritel || !jTSFloatWriteZ || !jTSFloatUpdatel (1 !jTSFloatUpdate2 1| 

•jTSFloatReadl || !jTSFloatRead2 |[1jTSFloatTakel || IjTSFloatTake2 || 

!jTSFloatTransWrite || !jTSFloatTransUpdate || !jTSFloatTransRead || 

jTSFloatTransTake) 

return FALSE; 

// TSLong 

tsClass = (*env)->FindClass(env, "tuplespace.core.TSLong"); 
jTSLongWritel = (*env)->GetMethodID(env, tsClass, "writel", ''(J)Z"); 
jTSLongWrite2 = (*env)->GetMethodID(env, tsClass, "write2", "(JJ)Z"); 
jTSLongUpdatel = (*env)->GetMeth.odID(env, tsClass, "updatel", "(J)Z"); 
jTSLongUpdateZ = (*env)”>GetMethodID(env, tsClass, "update2", "(JJ)Z"); 
jTSLongReadl = (*env)->GetMethodID(env, tsClass, "readlfExists", "OJ"); 
jTSLongRead2 = (*env)->GetMethodID(env, tsClass, "readlfExistsl", "(J)J")7 
jTSLongTakel = (*env)->GetMeth.odID (env, tsClass, " takelf Exists", "OJ"); 
jTSLongTake2 = (*env)->>GetMethodID (env, tsClass, "takelfExistsl", "(J)J"); 
jTSLongTransWrite = (*env)->GetMethodID(env, tsClass, "transWrite", "(JJ)Z"); 
jTSLongTransUpdate = (*env)->GetMethodID(env, tsClass, "transUpdate", "(JJ)Z"); 
jTSLongTransRead = {*env)->GetMethodID(env, tsClass, "transRead", "(J)J"); 
jTSLongTransTake = (*env)->GetMethodID(env, tsClass, "transTake", "(J)J"); 

if ('jTSLongWritel || !jTSLongWrite2 || !jTSLongUpdatel || «jTSLongUpdate2 || 

•jTSLongReadl || !jTSLongRead2 ||!jTSLongTakel || !jTSLongTake2 |1 
! jTSLongTransWrite || 'jTSLongTransUpdate j| ! j TSLongTransRead || 

jTSLongTransTake) 

return FALSE; 

// TSDouble 

tsClass - (*env)->FindClass(env, "tuplespace.core.TSDouble"); 
jTSDoubleWritel = (*env)->GetMethodID(env, tsClass, "writel", "(D)Z"); 
jTSDoubleWrite2 = (*env)->GetMethodID(env, tsClass, "write2", "(DJ)2"); 
jTSDoubleUpdatel = (*env)->GetMethodID(env, tsClass, "updatel", "(D)Z"); 
jTSDoubleUpdate2 = (*env)->GetMethodID(env, tsClass, "update2", "{DJ)Z"); 
jTSDoubleReadl = (*env)->GetMethodID(env, tsClass, "readlfExists", "OD"); 
jTSDoubleRead2 = (*env)-'>GetMethodID (env, tsClass, "readlfExistsl", "(J)D"); 
jTSDoubleTakel = (*env)->GetMeth.odID (env, tsClass, "takelf Exists", "OD"); 
jTSDoubleTake2 = (*env)->GetMethodID(env, tsClass, "takelfExistsl", "(J)D"); 
jTSDoubleTransWrite = (*env)“>GetMethodID(env, tsClass, "transWrite", "(DJ)Z"); 
jTSDoubleTransUpdate = (*env)->GetMethodID(env, tsClass, "transUpdate", "(DJ)Z"); 
jTSDoubleTransRead = (*env)->GetMethodID{env, tsClass, "transRead", "(J)D"); 
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jTSDoubleTransTake = (*env}->GetMethodID (env, tsClass, "transTake", "(J)D‘'); 

^ if (!jTSDoubleWritel || »jTSDoubleWrite2 || !jTSDoubleUpdatel i| !jTSDoubleUpdate2 

!jTSDoubleReadl || !jTSDoubleRead2 ||'jTSDoubleTakel || !jTSDoubleTake2 || 

!jTSDoubleTransWrite || !jTSDoubleTransUpdate || !jTSDoubleTransRead || 

jTSDoubleTransTake) 

return FALSE; 

// TSBoolean 

tsClass = (*env)->FindClass(env, "tuplespace.core.TSBoolean"); 
jTSBooleanWritel = (*env)->GetMethodID(env, tsClass, "writel", "{Z)Z"); 
jTSBooleanWrite2 = (*env)->GetMethodID(env, tsClass, "write2”, ''(ZJ}Z'’); 
jTSBooleanUpdatel = (*env)>>GetMethodID(env, tsClass, "updatel", "(Z)Z"); 
jTSBooleanUpdate2 = {*env)->GetMethodID(env, tsClass, "updateZ”, "(ZJ)Z'’); 
jTSBooleanReadl = (*env)->GetMethodID{env, tsClasS/ "readlfExists", ”()Z"); 
jTSBooleanRead2 = (*env)->GetMethodID {env, tsClass, " readlf Exist si", "(J)Z‘’); 
jTSBooleanTakel = < *env)->GetMethodID (env, tsClass, ” takel f Exist s", ''()Z''); 
jTSBooleanTake2 = {*env)->GetMethodID (env, tsClass, " takelfExistsl", ’'{J)Z*’); 
jTSBooleanTransWrite = (*env)->GetMethodID{env, tsClass, "transWrite”, "(ZJ)Z"); 
jTSBooleanTransUpdate = {*env)->GetMethodID(env, tsClass, " transUpdate", MZJ)Z*'); 
jTSBooleanTransRead = {*env}->GetMethodID(env, tsClass, "transRead", "(dlZ"); 
jTSBooleanTransTake = (*env}~>GetMethodID(env, tsClass, "transTake", MJ)Z"); 

if (!jTSBooleanWritel || !jTSBooleanWrite2 11 ! jTSBooleanUpdatel || 

jTSBooleanUpdate2 || 

!jTSBooleanReadl || !jTSBooleanRead2 I I!jTSBooleanTakel || 

jTSBooleanTake2 || 

!jTSBooleanTransWrite || !jTSBooleanTransUpdate || ‘jTSBooleanTransRead || 

jTSBooleanTransTake) 

return FALSE; 

// TSHash 

tsClass = (*env)~>FindClass(env, "tuplespace.core.TSHash"); 
jTSHashWritel = (*env)->GetMethodID{env, tsClass, "write", "OZ"); 
jTSHashWrite2 = (*env)->GetMethodID(env, tsClass, "writel", "{J)Z"); 
jTSHashUpdatel = (*env)->GetMethodID(env, tsClass, "update", "OZ"); 
jTSHashUpdate2 = (*env)->GetMethodID(env, tsClass, "updatel", "(J)Z"); 
jTSHashReadl = {*env)->GetMethodID(env, tsClass, "readlfExists", "OZ"); 
jTSHashRead2 = {*env)~>GetMethodID(env, tsClass, "readlfExistsl", "(J)Z"); 
jTSHashTakel = (*env)->GetMethodID(env, tsClass, "takelfExists", "()Z"); 
jTSHashTake2 = (*env)->GetMethodID(env, tsClass, "takelfExistsl", "(J)Z"); 
jTSHashTransWrite = (*env)->GetMethodID(env, tsClass, "transWrite", "(J)Z"); 
jTSHashTransUpdate = (*env)->GetMethodID(env, tsClass, "transUpdate", "(J)Z"); 
jTSHashTransRead = (*env)->GetMethodID(env, tsClass, "transRead", "(J)Z"); 
jTSHashTransTake = (*€nv)->GetMethodID(env, tsClass, "transTake", "(J)Z"); 

if (‘jTSHashWritel || !jTSHashWrite2 || ‘jTSHashUpdatel || !jTSHashUpdate2 || 

!jTSHashReadl || !jTSHashRead2 ||!jTSHashTakel || IjTSHashTake2 || 
‘jTSHashTransWrite || !jTSHashTransUpdate I !jTSHashTransRead || 

jTSHashTransTake) 

return FALSE; 


// TSString 

tsClass = (*env)->FindClass (env, "tuplespace.core.TSString") ,- 
■ jTSStringWritel = (*env)->GetMethodID (env, tsClass,. "writel", 

(Ljava/lang/String;)Z"); 

jTSStringWrite2 = (*env)->GetMethodID(env, tsClass, "write2", 

(Ljava/lang/String;J)Z"); 

jTSStringUpdatel = (*env)->GetMethodID(env, tsClass, "updatel", 

(Ljava/lang/String;)Z"); 

jTSStringUpdate2 = (*env)->GetMethodID(env, tsClass, "update2", 

(Ljava/lang/String;J)Z"); 

jTSStringReadl = (*env)->GetMethodID(env, tsClass, "readlfExists", 

0Ljava/lang/String;"); 

jTSStringRead2 = (*env)~>GetMethodID(env, tsClass, "readlfExistsl", 

(J)Ljava/lang/String;"); 
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(*env)->GetMethodID(env, 


tsClass, 


takelfExists”, 


jTSStringTakel = 

"()Ljava/lang/String;"); 

jTSStringTake2 = 

”(J)Ljava/lang/String;"); 

jTSStringTransWrite 
"(Ljava/lang/String;J)Z”); 

jTSStringTransUpdate 
"{Ljava/lang/String;J)Z”); 

j TSStringTransRead 
”(J)Ljava/lang/String;"); 

jTSStringTransTake 
"(J)Ljava/lang/String;"); 


(*env)->GetMethodID(env, 

(*env) ->GetMeth.odID(env, 
(*env)->GetMethodID(env, 
(*env)->GetMethodID(env, 
(*env)“>GetMethodlD(env. 


tsClass, 

tsClass, 

tsClass, 

tsClass, 

tsClasS/ 


"takelfExistsl”/ 
”transWrite”/ 
"transUpdate" / 
"transRead", 
”transTake", 


if (IjTSStringWritel || !jTSStringWrite2 || !jTSStringUpdatel || !jTSStringUpdate2 

!jTSStringReadl || !jTSStringRead2 ||'jTSStringTakel || !jTSStringTake2 || 

!jTSStringTransWrite || !jTSStringTransUpdate || !jTSStringTransRead || 

! jTSStringTransTake) 

return FALSE; 


logError("init Methods Ok!\n”); 
return TRUE; 

//- 

} 

void logError(char* string) 

{ 

printf("%s”, string); 

} 

//★*★**★**********★★★*★★★*★******★********★*★***★*****★************ 
// Terminate Agent - Stop agent and release all resources 
//***************************************************************** 

void endAgent(void) 

{ 

if ((*env)->ExceptionOccurred(env)) 

{*env)->Exceptionl>escribe(env) ; 

(* jvm) ->DestroyJavaVM (jvm) ; 

} 


int InitializeAgent(long timeout) 

{ 

if ( agentObject == 0 || jInitializeAgent ==0) 

{ 

logError ("Fail! Ini tializeAgent \n*'); 
return 0; 

} 

return (*env)->CallBooleanMethod(env, agentObject, jInitializeAgent, timeout); 

} 

//****★***★***************************★*******■*******************★★ 

// Set/Get AgentSecurityPolicy 

//*************★************★*★********•*•*************************** 
void setAgentSecurityPolicy(char* buf) 

{ 

jstring jstr; 

if ( agentObject == 0 1| jSetAgentSecurityPolicy ==0) 

{ 

logError("Fail! setAgentSecurityPolicy \n") ; 
return; 

} 
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j s tr = (* env)->NewStringUTF(env,buf); 

(*env)->CallVoidMethod(Gnv, agentObject, jSetAgentSecurityPolicy, jstr); 


void getAgentSecurityPolicy(char* buf) 

{ 

jstring jstr; 
const jbyte *str; 

if { agentObject == 0 || jGetAgentSecurityPolicy ==0) 

{ 

logErrorC'Faill getAgentSecurityPolicy Xn”) ; 
return; 

} 

jstr = (*env)~>CallObjectMethod(env, agentObject, jGetAgentSecurityPolicy) 
if(jstr != 0) 

{ 

str - (*env)“>GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprint f (buf, ''%s", str) ; 

(*env)->ReleaseStringUTFChars(env,j str, str); 

} 

else 

sprintf(buf," "); 

} 

//***★*★******★***★**★**★**★*****★****★*******★***********★**★*★*** 

// Set/Get AgentSpaceName 

//***************************************************************** 
void setAgentSpaceName(char* buf) 

{ 

jstring jstr; 

if ( agentObject == 0 || jSetAgentSpaceName ==0) 

{ 

logError("Fail! setAgentSpaceName \n"); 
return; 

> 

j str = (*env)->NewStringUTF(env,buf); 

(*env)->CallVoidMethod(env, agentObject, jSetAgentSpaceName, jstr); 

void getAgentSpaceName(char* buf) 

{ 

jstring jstr; 
const jbyte *str; 

if { agentObject == 0 || jGetAgentSpaceName ==0) 

{ 

logError("Fail! getAgentSpaceName \n"); 
return; 

} 

jstr = (*env) •“>CallObjectMethod(env, agentObject, j Get Agent SpaceName) ; 
if(jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf (buf, "%s'', str) ; 

(*env)->ReleasestringUTFChars(env,jstr,str); 

} 

else 

sprintf(buf,” "); 

} 

//*********★********************************★*★*★****★************* 

// Set/Get AgentServerCodebase 
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//**********************************************^****************** 
void setAgentServerCodebase(char* buf) 

{ 

jstring jstr; 

if ( agentObject == 0 || jSetAgentServerCodebase ==0) 

{ 

logError("Fail 1 setAgentServerCodebase Nn"); 
return; 

} 

j str = (*env)->NewStringUTF(env,buf); 

(*env)->CallVoidMethod(enV/ agentObject, jSetAgentServerCodebase, jstr); 

} 

void getAgentSeiTverCodebase (char* buf) 

{ 

jstring jstr; 
const jbyte *str; 

if ( agentObject == 0 |1 jGetAgentServerCodebase ==0) 

{ 

logError("Fail! getAgentServerCodebase \n”); 
return; 

} 

jstr = (*env)->CallObjectMethod(env, agentObject, jGetAgentServerCodebase) 
if(jstr 1= 0) 

{ 

str = {*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf(buf,"%s",str); 

{*env)->ReleaseStringUTFChars(env,j str,str); 

} 

else 

sprintf(buf," "); 

} 

//****★***■ ********************************************************* 

// Set/Get AgentLookupGroup 

//***************************************************************** 
void setAgentLookupGroup(char* buf) 

{ 

jstring jstr; 

if ( agentObject == 0 || jSetAgentLookupGroup ==0) 

{ 

logError("Fail! setAgentLookupGroup \n"); 
return; 

} 

j str = (* env) ->NewStringUTF (env, buf) ; 

(*env)->CallVoidMethod(env, agentObject, jSetAgentLookupGroup, jstr); 

} 

void getAgentLookupGroup(char* buf) 

{ 

jstring jstr; 
const jbyte *str; 

if ( agentObject == 0 || jGetAgentLookupGroup ==0) 

{ 

logError("Fail I getAgentLookupGroup \n"); 
return; 

} 

jstr = (*env)->CallObjectMethod(env, agentObject, jGetAgentLookupGroup); 
if(jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env,jstr,NULL); 
if(str 1= NULL) 

sprintf(buf,"%s",str); 

(*env)->ReleaseStringUTFChars(env,j str,str); 
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} 

else 


sprintf(buf," "); 

} 


// Set/Get AgentLookupURL 

//*★***★****★* ******************yf********************************** 

void setAgentLookupURL(char* buf) 

{ 

jstring jstr; 

if { agentObject == 0 || jSetAgentLookupURL ==0) 

{ 

logError{"Fail! setAgentLookupURL \n"); 
return; 

} 


j str = (*env)~>NewStringUTF(env,buf); 

{*env)->CallVoidMethod(env, agentObject, jSetAgentLookupURL, jstr); 


void getAgentLookupURL{char* buf) 

{ 

jstring jstr; 
const jbyte *str; 

if ( agentObject == 0 || jGetAgentLookupURL ==0) 

{ 

logError("Fail! getAgentLookupURL \n"); 
return; 

} 

jstr = (*env)->CallObjectMethod(env, agentObject, jGetAgentLookupXJRL) ; 
if(jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf(buf,"%s", str); 

{*env) -">ReleasestringUTFChars (env, jstr, str) ; 

} 

else 

sprintf(buf," "); 


} 

//**********★****★****••******* *********** ***********************^*** 

If Create/Remove tuple ID 

//**********************>*****.^*^****.**************.***.*********^*** 
int createID(int classType, char* objectID) 

{ 

jstring jstr; 

if ( agentObject == 0 || jCreatelD ==0 || objectID == 0) 

{ 

logError ("Fail! createlD \n") ,- 
return FALSE; 

} 

jstr = (*env)->NewStringUTF(env,objectID); 

return (*env)->CallBooleanMethod(env, agentObject, jCreatelD, classType, jstr); 

} 

int removeID(int classType,char* objectID) 

{ 

jstring jstr; 

if ( agentObject == 0 || jRemovelD ==0 || objectID == 0) 

{ 

logError("Fail! removelD \n"); 
return FALSE; 

} 
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jstr = (*env)->NewStringUTF{env,objectID); 

return {*env)->CallBooleanMethod{env, agentObject, jRemovelD, classType, jstr); 

} 

int cleanTSClass(int classType,char* objectID) 

{ 

jstring jstr; 

if ( agentObject == 0 || jCleanTSClass ==0 || objectID == 0) 

{ 

logError("Fail I cleanTSClass \n"); 
return FALSE; 

} 

jstr = (*env)->NewStringUTF(env,objectID); 

return (*env)->CallBooleanMethod(env, agentObject, jCleanTSClass, classType, 

jstr) ; 

> 

jobject getTSObject(int classType, char* objectID) 

{ 

jstring jstr; 

if { agentObject == 0 || jGetTSObject ==0 || objectID == 0) 

{ 

logError("Fail! getTSObject \n"); 
return 0; 

> 

jstr = (*env)“>NewStringUTF(env,objectID); 

return (*env)->CallObjectMethod(env, agentObject, jGetTSObject, classType, jstr); 

> 

int startTransaction() 

{ 

if ( agentObject == 0 || jStartTransaction ==0 ) 

{ 

logError("Fail i startTransaction \n"); 
return 0; 

} 

return (*env)->CallBooleariMethod(env, agentObject, jStartTransaction); 

} 

jobject getTransaction () 

{ 

if ( agentObject == 0 || jGetTransaction ==0 ) 

{ 

logError("Fail I getTransaction \n"); 
return 0; 

} 

return (*env)->CallObjectMethod{env, agentObject, jGetTransaction); 

} 

int isTransactionStarted() 

{ 

if { agentObject == 0 || jlsTransactionStarted ==0 ) 

{ 

logError("Fail! isTransactionStarted \n"); 
return 0; 

} 

return (*env)->CallBooleanMethod{env, agentObject, jlsTransactionStarted); 

} 

int abortTransaction{) 

{ 

if ( agentObject == 0 || jAbortTransaction ==0 ) 

{ 

logError("Fail! abortTransaction \n"); 
return 0; 

} 

return (*env)->CallBooleanMethod(env, agentObject, jAbortTransaction); 
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} 


int closeTransaction() 

{ 

if { agentObject == 0 | | jCloseTransaction =:=0 ) 

{ 

logError("Fail! closeTransaction \n"); 
return 0; 

} 

return (*env)->CallBooleanMethod(enV/ agentObject, jCloseTransaction); 

} 

int updateTransactionHandle(int classType, char* objectID) 

{ 

jstring jstr; 

if ( agentObject == 0 || jUpdateTransactionHandle =-0 || objectID -= 0) 

{ 

logError ("Fail! createlD \n'‘) ; 
return FALSE; 

} 

jstr = (*env)->NewStringUTF(env,objectID); 

return (*env)“>CallBooleanMethod(env, agentObject, jUpdateTransactionHandle, 

classType, jstr); 

} 

//***★*****************★*******************************.************************** 

//********■★*★*****★****★***★***************•************************ 

// TSInteger Methods 

//**•********★★*************★*************★************************* 

// *** Write *** 

int TSIntegerWritel(char* objectID, int value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_IMTEGER, objectID); 
if ( jTSIntegerWritel ==0 || jTSObject == 0) 

{ 

logError{"Fail! TSIntegerWritel \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod{env, jTSObject, jTSIntegerWritel, value); 

} 

int TSIntegerWrite2(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject ( (int)TS_I]SrTEGER, objectID); 
if ( jTSIntegerWritel ==0 |] jTSObject == 0) 

{ 

logError("Fail! TSIntegerWrite2 \n"); 
return FALSE; 

} 

return (*env)~>CallBooleanMethod(env, jTSObject, jTSIntegerWrite2, value, lease); 

} 


// *** Update *** 

int TSIntegerUpdatel(char* objectID, int value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS^INTEGER, objectID); 
if ( jTSIntegerUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSIntegerUpdatel \n"); 
return FALSE; 

} 

retuin {*env)->CallBooleanMethod(env, jTSObject, jTSIntegerUpdatel, value); 

} 
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int TSIntegerUpdate2(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 
if ( jTSIntegerUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSIntegerUpdate2 \n"); 
return FALSE; 

return (*env)->CallBooleanMethod{env, jTSObject, jTSIntegerUpdate2, value, lease) 

} 

// *** Read *** 

int TSIntegerReadl(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_INTEGER, objectID); 
if ( jTSIntegerReadl ==0 [| jTSObject == 0) 

{ 

logError("Fail! TSIntegerReadl Nn"); 
return FALSE; 

} 

return (*env)->CallIntMethod(env, jTSObject, jTSIntegerReadl); 

} 

int TSIntegerRead2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 
if { jTSlntegerRead2 ==0 |[ jTSObject == 0) 

{ 

logError("Fail! TSlntegerRead2 \n"); 
return FALSE; 

} 

return (*env)->CallIntMethod(env, jTSObject, jTSIntegerRead2, timeout); 

} 

// *** Take *** 

int TSIntegerTakel(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS„INTEGER, objectID); 
if { jTSIntegerTakel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSIntegerTakel \n"); 
return FALSE; 

} 

return (*env)->CallIntMethod(env, jTSObject, jTSIntegerTakel); 

} 

int TSIntegerTak€2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 
if { jTSInt€gerTake2 ==0 || jTSObject == 0) 

{ 

logError{"Fail! TSIntegerTake2 \n"); 
return FALSE; 

} 

return (*env)->CallIntMethod{env, jTSObject, jTSIntegerTake2, timeout); 

> 

// *** Transaction *** 

int TSIntegerTransWrite(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 
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0 I I updateTransactionHandle( 


if ( jTSIntegerTransWrite ==0 | | jTSObject == 

(int)TS_INTEGER, objectID)== 0) 

{ 

logErrorC’Fail! TSIntegerTransWrite \n") ; 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSIntegerTransWrite, value, 

lease); 

} 

int TSIntegerTransUpdate(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 

if ( jTSIntegerTransUpdate ==0 | | jTSObject ==0 | | updateTransactionHandle{ 

(int)TS_INTEGER, objectID)== 0) 

{ 

logError("Fail! TSIntegerTransUpdate \n"); 
return FALSE; 

} 

return (*env)“>CallBooleanMethod(env, jTSObject, jTSIntegerTransUpdate, value, 

lease) ; 

} 


int TSIntegerTransRead(char* objectID, long timeout) 

{ 

j obj ec t j TSObj ec t; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 

if ( jTSIntegerTransRead ==0 || jTSObject == 0 || updateTransactionHandle ( 

TS^INTEGER, objectID)== 0) 

{ 

logError("Fail! TSIntegerTransRead \n"); 
return FALSE; 

} 

return (*env)->CallIntMethod(env, jTSObject, jTSIntegerTransRead, timeout); 

} 

int TSIntegerTransTake(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_INTEGER, objectID); 

if ( j TSIntegerTransTake ==0 || jTSObject == 0 || updateTransactionHandle { 

TS_INTEGER, ObjectID)== 0) 

{ 

logError("Fail! TSIntegerTransTake Xn"); 
return FALSE; 

} 

return {*env)->CallIntMethod(env, jTSObject, jTSIntegerTransTake, timeout); 

} 

//****************-k*iririeie*tririi’Ki(*it*-k**-kit*-k-k-k***ir*ifk***ieif*-k-k-k-k*ir***it***ir***i(i(*ieir*-ki,* 

//*****-*****.*.**********************^*****************************^***.************ 

//**★**★*★**********★********★*****★*********★*****★*************** 

If TSFloat Methods 

//★***********-*************^**************************y,^*^^^^^^^^^^ 

If *** Write *** 

int TSFloatWritel(char* objectID, float value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_FLOAT, objectID); 
if ( jTSFloatWritel ==0 11 jTSObject == 0) 

{ 

logError ("Fail! TSFloatWri tel \n") ,- 
return FALSE; 

} 

return (*env)“>CallBooleanMethod(env, jTSObject, jTSFloatWritel, value); 

} 


152 



ixit TSFloatWrite2 (char* objectID, float value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_FLOAT, objectID); 
if ( jTSFloatWritel ==0 || jTSObject == 0) 

{ 

logError("Fail‘ TSFloatWrite2 \n"); 
return FALSE; 

return (*env)->CallBooleanMethod(env, jTSObject, jTSFloatWrite2, value, lease); 

} 

// *** Update *** 

int TSFloatUpdatel(char* objectID, float value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject{{int)TS_FLOAT, objectID); 
if ( jTSFloatUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSFloatUpdatel Xn"); 
return FALSE; 

} 

return {*env)->CallBooleanMethod(env, jTSObject, jTSFloatUpdatel, value); 

} 

int TSFloatUpdate2(char* objectID, float value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_FLOAT, objectID); 
if ( jTSFloatUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSFloatUpdate2 \n") ; 
return FALSE; 

} 

return (*env)«>CallBooleanMethod(env, jTSObject, jTSFloatUpdate2, value, lease); 

} 


// *** Read *** 

float TSFloatReadl(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS^FLOAT, objectID); 
if ( jTSFloatReadl ==0 [[ jTSObject == 0) 

{ 

logError("Fail! TSFloatReadl \n"); 
return FALSE ,- 

} 

return {*env)->CallFloatMethod(env, jTSObject, jTSFloatReadl); 

} 

float TSFloatRead2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_FL0AT, objectID); • 

if ( jTSFloatRead2 ==0 || jTSObject == 0) 

{ 

logError("Fail! TSFloatRead2 \n"); 
return FALSE; 

} 

return {*env)“>CallFloatMethod(env, jTSObject, jTSFloatRead2, timeout); 

} 

// *** Take *** 

float TSFloatTakel(char* objectID) 

{ 

jobject jTSObject; 
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jTSObject = getTSObject({xnt)TS_FLOAT, objectID); 
if ( jTSFloatTakel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSFloatTakel \n"); 
return FALSE; 

} 

return (*env)->CallFloatMethod{env, jTSObject, jTSFloatTakel); 

} 

float TSFloatTake2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject{(int)TS_FLOAT, objectID); 
if ( jTSFloatTake2 ==0 || jTSObject == 0) 

{ 

logError ("Fail! TSFloatTake2 \n'') ; 
return FALSE; 

} 

return (*env)->CallFloatMethod(env, jTSObject, jTSFloatTake2, timeout); 

} 

// *** Transaction *** 

int TSFloatTransWrite(char* objectID, float value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_FLOAT, objectID); 

if ( jTSFloatTransWrite ==0 || jTSObject == 0 || updateTransactionHandle ( 

(int)TS^FLOAT, objectID)== 0) 

{ 

logError("Fail! TSFloatTransWrite \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSFloatTransWrite, value, 

lease); 

} 

int TSFloatTransUpdate(char* objectID, float value, long lease) 
jobject jTSObject; 

jTSObject = getTSObject((int)TS_FLOAT, objectID); 

if ( jTSFloatTransUpdate ==0 || jTSObject == 0 || updateTransactionHandle { 

(int)TS_FLOAT, objectID)== 0) 

{ 

logError{"Fail! TSFloatTransUpdate \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSFloatTransUpdate, value, 

lease) ; 

} 


float TSFloatTransRead(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_FLOAT, objectID); 

if ( jTSFloatTransRead ==0 | | jTSObject == 0 | | updateTransactionHandle{ TS__FLOAT, 
objectID)== 0) 

{ 

logError{"Fail! TSFloatTransRead \n"); 
return FALSE; 

} 

return (*env)->CallFloatMethod(env, jTSObject, jTSFloatTransRead, timeout); 


float TSFloatTransTake(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS^FLOAT, objectID); 
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if ( jTSFloatTransTake ==0 || jTSObject == 0 || updateTransactionHandle( TS_FLOAT, 
objectID)== 0) 

{ 

logError{"Fail! TSFloatTransTake \n"); 
return FALSE; 

} 

return {*env)->CallFloatMethod(env. jTSObject, jTSFloatTransTake, timeout); 

> 

//***★****★****★*★****************★★*********★*****************************’►***** 

//***★**★*★***************:»:*★****************★★*★**•****************•***★********•** 

//**•★★*******★******★************•***★**★**************★**★*****★*** 

// TSLong Methods 

//***★★************************************************************ 

// *** Write *** 

int TSLongWritel(char* objectID, long value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if ( jTSLongWritel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSLongWritel \n"); 
return FALSE; 

} , 

return (*env)->CallBooleanMethod(env, jTSObject, jTSLongWritel, value); 

} 

int TSLongWrite2(char* objectID, long value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if ( jTSLongWritel || jTSObject == 0) 

{ 

logError("Fail! TSLongWrite2 \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSLongWrite2, value, lease); 

} 


// *** Update *** 

int TSLongUpdatel (char* objectID, long value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if ( jTSLongUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSLongUpdatel \n"); 
return FALSE 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSLongUpdatel, value); 

} 

int TSLongUpdate2(char* objectID, long value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if ( jTSLongUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSLongUpdate2 \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSLongUpdate2, value, lease) ,- 

} 


// *** Read *** 

long TSLongReadl(char* objectID) 
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{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if { jTSLongReadl ==0 || jTSObject == 0) 

{ 

logError("Fail! TSLongReadl \n"}; 
return FALSE; 

} 

return (long)(*env)->CallLongMethod{env, jTSObject, jTSLongReadl); 

} 

long TSLongRead2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_LONG, objectID); 
if ( jTSLongRead2 ==0 || jTSObject =- 0) 

{ 

logError("Fail! TSLongRead2 \n"); 
return FALSE; 

} 

return (long)(*env)->CallLongMethod(env, jTSObject, jTSLongRead2, timeout); 

} 

// *** Take *** 

long TSLongTakel(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if ( jTSLongTakel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSLongTakel \n"); 
return FALSE; 

} 

return (long)(*env)->CallLongMethod(env, jTSObject, jTSLongTakel); 

} 

long TSLongTake2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 
if { jTSLongTake2 ==0 || jTSObject == 0) 

{ 

logError ("Fail! TSLongTake2 \n''); 
return FALSE; 

} 

return (long)(*env)->CallLongMethod(env, jTSObject, jTSLongTake2, timeout); 

} 

// *** Transaction *** 

int TSLongTransWrite(char* objectID, long value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 

if ( jTSLongTransWrite ==0 | | jTSObject ==0 | | updateTransactionHandle( 

{int)TS_LONG, objectID)== 0) 

{ 

logError("Fail! TSLongTransWrite \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, j TSLongTransWrite, value, lease) ,- 

} 

int TSLongTransUpdate(char* objectID, long value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_LONG, objectID); 

if ( jTSLongTransUpdate ==0 |1 jTSObject == 0 || updateTransactionHandle( 

(int)TS_LONG, objectID)== 0) 

{ 
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logError("Fail! TSLongTransUpdate \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod{env, jTSObject, jTSLongTransUpdate, value, 

lease) ; 

} 


long TSLongTransRead(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject{(int)TS_LONG, objectID); 

if ( jTSLongTransRead ==0 | | jTSObject == 0 | | updateTransactionHandle( TS_LONG, 

ObjectID)== 0) 

{ 

logError("Fail! TSLongTransRead \n"); 
return FALSE; 

} 

return (long)(*env)->CallLongMethod(env, jTSObject, jTSLongTransRead, timeout); 

} 

long TSLongTransTake(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject{(int)TS_LONG, objectID); 

if ( j TSLongTransTake ==0 | | jTSObject == 0 | | updateTransactionHandle ( TS_LONG, 

objectID)== 0) 

{ 

logError("Fail! TSLongTransTake \n"); 
return FALSE; 

} 

return (long)(*env)->CallLongMethod(env, jTSObject, jTSLongTransTake, timeout); 

} 

//****★★********★**********★**********★★************★*****★********★************* 

//*★**★*•**********•★**★**★**★*★***★★★**★***★**★***★★***********★********★********* 

//************★★************★★★************************************ 

// TSDouble Methods 

//***★****★*★*★****★*********************************************** 

// *** Write *** 

int TSDoubleWritel(char* objectID, double value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if { jTSDoubleWritel ==0 1| jTSObject == 0) 

{ 

logError("Fail! TSDoubleWritel \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSDoubleWritel, value); 

} 

int TSDoubleWrite2(char* objectID, double value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSDoubleWritel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSDoubleWrite2 \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSDoubleWrite2, value, lease); 

} 


// *** Update *** 

int TSDoubleUpdatel(char* objectID, double value) 

{ 
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j obj e c t j T sob j ec t; 

jTSObject = getTSObject{(int)TS_DOUBLE, objectID); 
if ( jTSDoubleUpdatel ==0 || jTSObject == 0) 

{ 

logError{"Fail! TSDoubleUpdatel \n"); 
return FALSE; 

} 

return {*env)->CallBooleanMethod{env, jTSObject, jTSDoubleUpdatel, value); 

int TSDoubleUpdate2(char* objectID, double value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if { jTSDoubleUpdatel ==0 || jTSObject == 0) 

{ 

logError ("Fail! TSDoubleUpdate2 \n") ,- 
return FALSE ,- 

} 

return (*env)~>CallBooleanMethod(env, jTSObject, jTSDoubleUpdate2, value, lease) 


// *** Read *** 

double TSDoubleReadl(char* objectID) 

{ 

jobject jTSObject; 

jTSObject - getTSObject((int)TS_DOUBLE, objectID); 
if { jTSDoubleReadl ==0 || jTSObject == 0) 

{ 

logError("Fail! TSDoubleReadl \n"); 
return FALSE; 

} 

return (*env)->CallDoubleMethod(env, jTSObject, jTSDoubleReadl); 

} 

double TSDoubleRead2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSDoubleRead2 ==0 |] jTSObject == 0) 

{ 

logError{"Fail! TSDoubleRead2 \n"); 
return FALSE; 

} 

return (*env)->CallDoubleMethod(env, jTSObject, jTSDoubleRead2, timeout); 

} 

// *** Take *** 

double TSDoubleTakel(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSDoubleTakel ==0 || jTSObject == 0) 

{ 

logError("Fail I TSDoubleTakel \n"); 
return FALSE; 

} 

return (*env)->CallDoubleMethod(env, jTSObject, jTSDoubleTakel); 

} 

double TSDoubleTake2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSDoubleTake2 ==0 || jTSObject == 0) 

{ 

logError("Fail I TSDoubleTake2 \n"); 
return FALSE; 
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} 

return (*env)->CallDoubleMethod(env, jTSObject, jTSDoubleTake2, timeout); 

} 

// *** Transaction *** 

int TSDoubleTransWrite(char* objectID, double value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_DOUBLE, objectID); 

if { jTSDoubleTransWrite ==0 |1 jTSObject == 0 || updateTransactionHandle ( 

{int)TS_DOUBLE, objectID) == 0) 

{ 

logError("Fail! TSDoubleTransWrite \n"); 
return FALSE; 

return {*env)->CallBooleanMethod{env, jTSObject, jTSDoubleTransWrite, value, 

lease); 

} 

int TSDoubleTransUpdate(char* objectID, double value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_DOUBLE, objectID); 

if ( jTSDoubleTransUpdate ==0 || jTSObject == 0 1| updateTransactionHandle ( 

(int)TS_DOUBLE, objectID)== 0) 

{ 

logError ("Fail 5 TSDoubleTransUpdate \n'') ; 
return FALSE; 

return (*env) -‘>CallBooleanMethod(env, jTSObject, jTSDoubleTransUpdate, value, 

lease); 

} 


double TSDoubleTransRead(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if ( jTSDoubleTransRead ==0 |1 jTSObject == 0 11 updateTransactionHandle ( 

TS_DOUBLE, objectID)== 0) 

{ 

logError("Fail! TSDoubleTransRead \n"); 
return FALSE; 

} 

return (*env)->CallDoubleMethod(env, jTSObject, jTSDoubleTransRead, timeout); 

} 

double TSDoubleTransTake(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if { jTSDoubleTransTake ==0 | | jTSObject == 0 | [ updateTransactionHandle{ 

TS_DOUBLE, ObjectID)== 0) 

{ 

logError {"Fail! TSDoubleTransTake \n") ,- 
return FALSE; 

} 

return (*env)->CallDoubleMethod(env, jTSObject, jTSDoubleTransTake, timeout); 

} 

f /**★***★*★****★*★*****★*************★***★****★********************************** 

//**★*■**************************★************************************************ 

//*******★*****★********★*******★********************************** 

// TSBoolean Methods 

//****************★********★★***★****★**********************♦****** 

II *** Write *** 

int TSBooleanWritel(char* objectID, int value) 
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{ 

jobject jTSObject; 

jTSObject = getTSObject{(int)TS_DOUBLE, objectID); 
if ( jTSBooleanWritel ==0 || jTSObject == 0) 

{ 

logError (’’Fail! TSBooleanWritel Xn"); 
return FALSE; 

} 

return (*env)->CallBooieanMethod(env, jTSObject, jTSBooleanWritel, value); 

int TSBooleanWrite2(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject({int)TS_DOUBLE, objectID); 
if ( jTSBooleanWritel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSBooleanWrite2 \n") ; 
return FALSE; 

} 

^ return (*env)‘>CallBooleanMethod(env, jTSObject, jTSBooleanWrite2, value, lease); 


// *** Update *** 

int TSBooleanUpdatel(char* objectID, int value) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSBooleanUpdatel ==0 [| jTSObject == 0) 

{ 

logError("Fail! TSBooleanUpdatel Xn"); 
return FALSE; 

} 

^ return (*env)->CallBooleanMethod(env, jTSObject, jTSBooleanUpdatel, value); 

int TSBooleanUpdate2(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int>TS_DOUBLE, objectID); 
if { jTSBooleanUpdatel ==0 || jTSObject == 0) 

{ 

logError{"Fail! TSBooleanUpdate2 Xn"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod{env, jTSObject, jTSBooleanUpdate2, value, lease) 


// *** Read *** 

int TSBooleanReadl(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSBooleanReadl ==0 |[ jTSObject == 0) 

{ 

logError("Fail! TSBooleanReadl Xn">; 
return FALSE; 

} 

return (*env)“>CallBooleanMethod(env, jTSObject, jTSBooleanReadl); 

} 

int TSBooleanRead2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSBooleanRead2 ==0 || jTSObject == 0) 

{ 
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logError("Fail! TSBooleanRead2 \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod{env, jTSObject, jTSBooleanRead2, timeout); 

} 

// *** Take *** 

int TSBooleanTakel(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSBooleanTakel ==0 [| jTSObject == 0) 

{ 

logError("Fail! TSBooleanTakel \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSBooleanTakel); 

} 

int TSBooleanTake2(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSBooleanTake2 ==0 || jTSObject == 0) 

{ 

logError("Fail! TSBooleanTake2 \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(€nv, jTSObject, jTSBooleanTake2, timeout); 

> 

// *** Transaction *** 

int TSBooleanTransWrite(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if ( jTSBooleanTransWrite ==0 | | jTSObject == 0 | | updateTransactionHandle( 

(int)TS_DOUBLE, objectID)== 0) 

{ 

logError("Fail! TSBooleanTransWrite \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSBooleanTransWrite, value, 

lease); 

} 

int TSBooleanTransUpdate(char* objectID, int value, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_D0UBLE, objectID); 

if ( jTSBooleanTransUpdate ==0 | | jTSObject == 0 | | updateTransactionHandle( 

(int)TS_DOUBLE, objectID)== 0) 

{ 

logError("Fail! TSBooleanTransUpdate \n”); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSBooleanTransUpdate, value, 

lease); 

} 


int TSBooleanTransRead(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if ( jTSBooleanTransRead ==0 1| jTSObject == 0 || updateTransactionHandle ( 

TS_DOUBLE, ObjectID)== 0) 

{ 

logError("Fail! TSBooleanTransRead \n"); 
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return FALSE; 


} 

return (*env)->CallBooleanMet]iod(env, jTSObject, jTSBooleanTransRead, timeout); 

} 

int TSBooleanTransTake(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if { jTSBooleanTransTake ==0 || jTSObject == 0 || updateTransactionHandle( 

TS_DOUBLE, objectID)== 0) 

{ 

logError("Fail! TSBooleanTransTake \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSBooleanTransTake, timeout); 

} 


//**•**********************★★*******★*******************★★*******★** 

// TSString Methods 

//*********★***************************************.**************** 

// *** Write *** 

int TSStringWritel(char* objectID, char* inputstring) 

{ 

jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 
if ( jTSStringWritel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringWritel \n"); 
return FALSE; 

} 

j str = (*env)->NewStringUTF(env,inputString); 
if(jstr 1= 0) 

return (*env)->CallBooleanMethod(env, jTSObject, jTSStringWritel, jstr); 

else 

return FALSE; 

} 

int TSStringWrite2(char* objectID, char* inputstring, long lease) 

{ 

jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject{(int)TS_STRING, objectID); 
if ( jTSStringWrite2 ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringWrit€2 \n"); 
return FALSE; 

} 

jstr = (*env)->NewStringUTF(env,inputString); 

return (*env)->CallBooleanMethod(env, jTSObject, jTSStringWrite2, jstr, lease); 


// *** Update *** 

int TSStringUpdatel(char* objectID, char* inputstring) 
{ 

jobject jTSObject; 
jstring jstr; 
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jTSObject = getTSObject((int)TS_STRING, objectID); 
if ( jTSStringUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringUpdatel \n"); 
return FALSE; 

} 

j str = {*env)>>NewStringUTF(env,inputstring); 
if(jstr != 0) 

return (*env)->CallBooleanMethod{env, jTSObject, jTSStringUpdatel, jstr) 

else 

return FALSE; 

} 

int TSStringUpdate2(char* objectID, char* inputstring, long lease) 

{ 

jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 

if ( jTSStringUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringUpdate2 \n"); 
return FALSE; 

} 

jstr = {*env)->NewStringUTF(env,inputstring); 

return (*env)->CallBooleanMethod{env, jTSObject, jTSStringUpdate2, jstr, lease) 

> 


// *** Read *** 

void TSStringReadl(char* objectID, char* outputBuf) 

const jbyte *str; 
jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 
if { jTSStringReadl ==0 |1 jTSObject == 0) 

{ 

logError("Fail! TSStringReadl \n"); 

} 

jstr = (*env)->CallObjectMethod{env, jTSObject, jTSStringReadl); 
if(jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env, jstr,NULL) ; 
if(str != NULL) 

sprintf(outputBuf,"%s",str); 

(*env)->ReleaseStringUTFChars(env,jstr,str) ; 

} 

else 

sprintf(outputBuf," "); 

} 

void TSStringR€ad2(char* objectID, char* outputBuf, long timeout) 

{ 

const jbyte *str; 
jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 
if ( jTSStringRead2 ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringRead2 \n"); 
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} 


jstr = {*env)->CallObjectMethod(env, jTSObject, jTSStringRead2, timeout); 
if{jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf{outputBuf,"%s",str); 

(*env) '->ReleaseStringUTFChars (env, jstr, str) ; 

} 

else 

sprintf(outputBuf," ”); 

} 


// *** Take *** 

void TSStringTakel(char* objectID, char* outputBuf) 

{ 

const jbyte *str; 
jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject ((int)TS_STRING, objectID) ,- 
if { jTSStringTakel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringTakel Nn"); 

} 

jstr = (*env)->CallObjectMethod(env, jTSObject, jTSStringTakel); 
if(jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf(outputBuf,"%s",str); 

(*env) ’->ReleaseStringUTFChars (env, jstr, str) ; 

} 

else 

sprint f (outputBuf, ") ; 

} 

void TSStringTake2(char* objectID, char* outputBuf, long timeout) 

{ 

const jbyte *str; 
jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 
if ( jTSStringTake2 ==0 || jTSObject == 0) 

{ 

logError("Fail! TSStringTake2 \n"); 

} 

jstr = (*env)->CallObjectMethod(env, jTSObject, jTSStringTake2, timeout); 
if{jstr != 0) 

{ 

str = (*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf(outputBuf,"%s",str); 

(*env)“>ReleasestringUTFChars(env,jstr,str); 

} 

. else 

sprintf(outputBuf," "); 

} 

// *** Transaction *** 

int TSStringTransWrite(char* objectID, char* inputstring, long lease) 

{ 

jobject jTSObject; 
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jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 

if ( jTSStringWritel ==0 || jTSObject == 0 1| updateTransactionHandle ( 

{int)TS_STRING, objectID)== 0) 

{ 

logError{"Fail! TSStringTransWrite \n”); 
return FALSE; 

} 

jstr = (*env)->NewStringUTF{env,inputstring); 

return (*env)->CallBooleanMethod(env, jTSObject, jTSStringTransWrite, jstr, 

lease) ; 

} 

int TSStringTransUpdate(char* objectID, char* inputstring, long lease) 

{ 

jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject{(int)TS_STRING, objectID); 

if ( jTSStringWritel ==0 || jTSObject == 0 | | updateTransactionHandle ( TS_STRING, 
objectID) =:= 0) 

{ 

logError("Fail! TSStringUpdate2 \n"); 
return FALSE; 

} 

jstr = (*env) ->NewStringUTF (env, input String) ,- 

return (*env)->CallBooleanMethod(env, jTSObject, jTSStringTransUpdate, jstr, 

lease); 

} 

void TSStringTransRead(char* objectID, char* outputBuf, long timeout) 

{ 

const jbyte *str; 
jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject((int)TS_STRING, objectID); 

if ( jTSStringWritel ==0 | | jTSObject ==011 updateTransactionHandle( TS_STRING, 
objectID)== 0) 

{ 

logError("Fail! TSStringTransRead \n"); 

} 

jstr = (*env)->CallObject)\5ethod(env, jTSObject, j TSStringTransRead, timeout); 
if(jstr != 0) 

{ 

str = {*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf(outputBuf,"%s",str); 

(*env)->ReleaseStringUTFChars(env,jstr,str); 

} 

else 

sprintf(outputBuf," "); 

} 

void TSStringTransTake(char* objectID, char* outputBuf, long timeout) 

{ 

const jbyte *str; 
jobject jTSObject; 
jstring jstr; 

jTSObject = getTSObject{(int)TS_STRING, objectID); 

if ( jTSStringWritel ==0 | | jTSObject == 0 | | updateTransactionHandle( TS_STRING, 
objectID)== 0) 

{ 

logError("FailI TSStringTransTake \n"); 
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} 


jstr = (*env)->CallObjectMethod(env, jTSObject, jTSStringTransTake, timeout) 
if(jstr != 0) 

{ 

str = {*env)->GetStringUTFChars(env,jstr,NULL); 
if(str != NULL) 

sprintf(outputBuf,"%s",str); 

{*Gnv)->ReleaseStringUTFChars(env, jstr,str); 

} 

else 

sprintf(outputBuf," "); 

} 

//****★***★★***********•********★****★******★********************★******★**★*.***** 

//**★★******★****★************************************************* 

// TSHash Methods 

y/ *****■★***★**■************★******★***********★****★***************★ 

// *** Write *•** 

int TSHashWritel(char* objectID) 

{ 

jobject jTSObject; 

jTSObject = getTSObject{(int)TS_DOUBLE, objectID); 
if ( jTSHashWritel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSHashWritel Xn") ; 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSHashWritel); 

} 

int TSHashWrite2(char* objectID, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 
if ( jTSHashWritel ==0 || jTSObject == 0) 

{ 

logError {"Fail! TSHashWrite2 \n‘') ; 
return FALSE; 

} 

return (*env)->CallBooleanMethod{env, jTSObject, jTSHashWrite2, lease); 

} 


// *** Update *** 

int TSHashUpdatel(char* objectID) 

{ 

jobject jTSObject; 

jTSObj ect = getTSObj ect ( (int) TS__DOUBLE, obj ectID) ; 
if ( jTSHashUpdatel ==0 | j jTSObject == 0) 

{ 

logError{"Fail! TSHashUpdatel \n"); 
return FALSE; 

) 

return (*env)->CallBooleanMethod(env, jTSObject, jTSHashUpdatel); 

} 

int TSHashUpdate2(char* objectID, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS^DOUBLE, objectID); 
if ( jTSHashUpdatel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSHashUpdate2 \n"); 
return FALSE; 

} 

return {*env) >>CallBool eanMethod (env, jTSObject, jTSHashUpdate2, lease) ,- 

} 
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11 *** Read *** 

int TSHashReadl(char* objectiD) 

{ 

jobject jTSObject; 

jTSObject = getTSObject ( (int)TS__DOUBLE, objectID) ; 
if ( jTSHashReadl ==0 || jTSObject == 0) 

{ 

logError{"Fail I TSHashReadl \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod{env, jTSObject, jTSHashReadl); 

} 

int TSHashRead2(char* objectiD, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectiD); 
if { jTSHashRead2 ==0 || jTSObject == 0) 

{ 

logError("Fail I TSHashRead2 \n"); 
return FALSE; 

} 

return (*env) •>>Ca 11 Boole anMethod (env, jTSObject, jTSHashRead2, timeout); 

} 

// *** Take *** 

int TSHashTakeKchar* objectiD) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectiD); 
if ( jTSHashTakel ==0 || jTSObject == 0) 

{ 

logError("Fail! TSHashTakel \n"); 
return FALSE ,- 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSHashTakel); 

> 

int TSHashTake2(char* objectiD, long timeout) 

C 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectiD); 
if { jTSHashTake2 ==0 || jTSObject == 0) 

{ 

logError("Fail' TSHashTake2 \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(€nv, jTSObject, jTSHashTake2, timeout); 

} 

// *** Transaction *** 

int TSHashTransWrite(char* objectiD, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectiD); 

if ( j TSHashTransWrite ==0 [ | jTSObject == 0 | | updateTransactionHandle ( 

(int)TS_DOUBLE, objectiD)== 0) 

{ 

logError ("Fail I TSHashTransWrite \n"),- 
retum FALSE; 

• } 

return (*env)->CallBooleanMethod(env, jTSObject, jTSHashTransWrite, lease); 

} 

int TSHashTransUpdate(char* objectiD, long lease) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectiD); 
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if ( jTSHashTransUpdate ==0 || jTSObject == 0 || updateTransactionHandle( 

(int)TS_DOUBLE, objectID)== 0) 

{ 

logError("Fail! TSHashTransUpdate \n"); 
return FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSHashTransUpdate, lease) ,- 

} 


int TSHashTransRead(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if ( jTSHashTransRead ==0 || jTSObject == 0 || updateTransactionHandle( TS^DOUBLE, 
ObjectID)== 0) 

{ 

logError{"Fail! TSHashTransRead \n"); 
return FALSE; 

} 

return {*env)->CallBooleanMethod{env, jTSObject, jTSHashTransRead, timeout); 

} 

int TSHashTransTake(char* objectID, long timeout) 

{ 

jobject jTSObject; 

jTSObject = getTSObject((int)TS_DOUBLE, objectID); 

if ( jTSHashTransTake ==0 || jTSObject == 0 || updateTransactionHandle( TS_DOUBLE, 
objectID)== 0) 

{ 

logError("Fail! TSHashTransTake \n"); 
retum FALSE; 

} 

return (*env)->CallBooleanMethod(env, jTSObject, jTSHashTransTake, timeout); 

} 
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APPENDIX E. AGENT API LISTING 


A. SERVICE PACKAGE 

1. AgentServicelnterfacejava 

// This is the interface that the service's proxy 
// implements 

package tuplespace.services; 

pxiblic interface AgentServiceInterface { 
public String getMessage(); 

public boolean joinService{String id, String password); 
public boolean endService0; 

} 

2. AgentServicejava 

package tuplespace.services; 

import net.jini.discovery.DiscoveryListener; 

import net.jini.discovery.DiscoveryEvent; 

import net. j ini. discovery. Loo3cupDiscovery; 

import net.jini.core.entry.*; 

import net.jini.lookup,entry.*; 

import net.jini.core.lookup.Serviceltem; 

iiport net.jini.core.lookup.ServiceRegistrar; 

import net.jini.core.lookup.ServiceRegistration; 

import net.jini.core.lease.Lease; 

import net.jini.core.lease.UnknownLeaseException; 

import java.util.Hashtable; 

import java.io.lOException; 

import java.io.Serializable; 

import j ava. rmi . RemoteException; 

import j ava. rmi . RMI Securi tyManager ; 

import java.util.Vector; 

import java.util.Emjmeration; 

// This is the proxy object that will be downloaded 
// by clients. It's serializable and implements 
// our well-known AgentServiceInterface. 
class AgentServiceProxy implements Serializable, 
AgentServiceInterface { 
public AgentServiceProxy0 { 

} 

public String getMessage() { 
return "Hello, world!"; 

} 

public boolean joinService{String id. String password){ 
return true; 

> 

public boolean endService0{ 
return true; 

} 

} 

// AgentService is the "wrapper" class that 
// handles publishing the service item, 
public class AgentService implements Runnable { 

// 10 minute leases 

protected Thread leaseThread = null; 

protected final int LEASE_TIME = 10 * 60 * 1000; 

protected Hashtable registrations = new HashtableO; 

protected Serviceltem item; 

protected LookupDiscovery disco; 

// Inner class to listen for discovery events 
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class Listener implements DiscoveryListener { 

// Called when we find a new lookup service, 
public void discovered(DiscoveryEvent ev) { 

System, out .println ("discovered a lookup service!'*); 

ServiceRegistrar[] newregs = ev.getRegistrars(); 
for (int i=0 ; i<newregs.length ; i++) { 

if (!registrations.containsKey(newregs[i])) { 
registerWithLookup(newregs[i]); 

} 

} 

} 

// Called ONLY when we explicitly discard a 
// lookup service, not "automatically" when a 
// lookup service goes down. Once discovered, 

// there is NO ongoing communication with a 
// lookup service. 

public void discarded(DiscoveryEvent ev) { 

ServiceRegistrar[] deadregs = ev.getRegistrars(); 
for (int i=0 ; i<deadregs.length ; i++) { 
registrations.remove(deadregs[i]); 

} 

} 

} 

public AgentService() throws lOException { 

item = new Serviceltern(null, createProxy(), getAttributes()); 

// Set a security manager 

if (System.getSecurityManager() == null) { 

System.setSecurityManager(new RMISecurityManager()); 

} 

// Search for the "public" group, which by 
// convention is named by the empty string 
disco = new LookupDiscovery(new String[) { "" }); 

// Install a listener, 

disco.addDiscoveryLiStener(new Listener()); 

} 

protected AgentServiceInterface createProxy() { 
return new AgentServiceProxy(); 

} 

// This work involves remote calls, and may take a 
// while to complete. Thus, since it's called from 
// discovered{), it will prevent us from responding 
// in a timely fashion to new discovery events. An 
// improvement would be to spin off a separate short- 
// lived thread to do the work. 

protected synchronized void registerWithLookup(ServiceRegistrar registrar) { 
ServiceRegistration registration = null; 

try { 

registration = registrar.register(item, LEASE_TIME); 

} catch (RemoteException ex) { 

System.out.println{"Couldn't register: " + ex.getMessage()); 
return; 

} 

// If this is our first registration, use the 
// service ID returned to us. Ideally, we should 
// save this ID so that it can be used after 
// restarts of the service 
if (item.servicelD == null) { 

item.servicelD = registration.getServiceID(); 

System.out.println("Set servicelD to " + item.servicelD); 

} 
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} 


registrations.put{registrar/ registration); 
leaseThread-interrupt(); 


// run now maintains our leases 
public void runO { 
while (true) { 
try { 

long sleepTime = computeSleepTime(); 
Thread.sleep{sieepTime); 
renewLeases{) ; 

} catch (InterruptedException ex) { 

} 


} 


) 


// Figure out how long to sleep. 

protected synchronized long computeSleepTime() { 
long soonestExpiration = Long. MAX_VALUE 
Enumeration enum = registrations .elements () ; 
whi 1 e (enirni.hasMoreElements()) { 

Lease 1 = ((ServiceRegistration) enum.nextElement0).getLease(); 
if (l.getExpirationO - (20 * 1000) < soonestExpiration) C 
soonestExpiration = l.getExpirationO - (20 * 1000); 

} 

} 

long now = System.currentTimeMillis () ; 

if (now >= soonestExpiration) { 
return 0; 

} else { 

return soonestExpiration - now; 

} 

} 

//Do the work of lease renewal, 
protected synchronized void renewLeases() { 
long now = System. currentTimeMillis 0 ; 

Vector deadLeases = new Vector(); 

Enumeration keys = registrations .keys () ; 
whi1e (keys.hasMoreElement s()) { 

ServiceRegistrar lu = (ServiceRegistrar) keys.nextElementO; 
ServiceRegistration r = (ServiceRegistration) registrations.get(lu) 
Lease 1 = r.getLease(); 
if (now <= l.getExpirationO && 

now >= l.getExpirationO - (20 * 1000)) { 
try { 

System.out.printIn("Renewing lease."); 

1.renew(LEASE_TIME); 

} catch (Exception ex) { 

System.err.printIn{"Couldn’t renew lease: " + 
ex.getMessage()); 
deadLeases.addElement(lu); 

} 

} 

} 

// clean up after any leases that died 
for (int i=0/ size=deadLeases.sizeO ; i<size ; i++) { 
registrations.remove(deadLeases.elementAt(i)); 

} 

} 

protected Entry[] getAttributesO{ 
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Entry [] entries = new Entry[2] ; 
entries[0] = new Serviceinfo("Tiptop", 

"Agent", 
"Agent", 

"Tiptop", 
"vl.O"); 

entries[1] = new Name("Agent"); 
return entries; 


// Create the service and start the leasing 
// thread. 

public static void main(String args[]) { 
try { 

AgentService hws = new AgentService{); 
hws.leaseThread = new Thread (hws) ; 
hws.leaseThread.start(); 

} catch (lOException ex) { 


System.out.println("Couldn't create service: " + 


} 


ex.getMessage()); 


} 
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B. CORE PACKAGE 
1. Agentjava 

package tuplespace.core; 


irtport java.net.URLClassLoader; 
iirport java.net.URL; 

import java.net.MaiformedURLException ; 
inport tuplespace.entries.*; 

import net.jini.core.entry.UnusableEntryException; 

import net.jini.core.lease.Lease; 

inport net.jini.core.transaction.*; 

inport net-jini.core.transaction-server.*; 

inport net.jini.space.JavaSpace; 

inport java.util.*; 

inport j ava. awt. event. * ; 

j -k ir 

* The <code>Agent</code> class implements the methods to 

* configure agent properties, establish connection with Jini Services, 

* request for transaction and create new entry handlers 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 
*/ 

public class Agent inplements java.io.Serializable, SpaceActionHandler, TSConstants 
{ 

private JavaSpace space; 
private TransactioziManager txnMgr; 
private Transaction txn; 
private TSList tsList; 
private TSStack tsStack; 

private Vector pushListeners = new Vector(); 

private Map tsStringMap; 

private Map tsBooleanMap; 

private Map tsIntegerMap; 

private Map tsFloatMap; 

private Map tsLongMap; 

private Map tsDoubleMap; 

private Map tsQueueMap; 

private Map tsStackMap; 

private Map tsLinkListMap; 

private Map tsHashMap; 


public Agent 0 

{ 


System. setProperty ("java, security, policy", "d: \ \ jinil_l\\exainple\\books\\policy .all"); 
System.setProperty ("outrigger.spacename"," JavaSpaces") ; 

//System. setProperty ("com.sun. jini .lookup.locator",null); // unicast 


property to a proper jini URL 

System. setProperty (" com. sun. j ini. lookup. groups", "public") ; 

System.setProperty("java.rmi.server.codebase","http://tiptop:8081/entries.jar") 
System.out.println(" *** Default System properties ***"); 

System. out.printIn(" 1. Security Policy : 

System. getProperty( "java, security.policy") ) ; 

System.out.printIn(" 2. Space Name • 

System.getProperty( "outrigger. spacename")) ; 

System, out. pr in tin (" 3. Server Codebase : 

System.getProperty("j ava-rmi.server.codebase")); 

System.out.println(" 4. Loolcup URL ^ 

System.getProperty( "com.sun. jini .lookup, locator")) ; 

System.out.printin(" 5. Lookup groups • 

System. getProperty (" com. sun. j ini. lookup. groups ")); 

System.out.printIn("... Agent Loaded \ but still not started"); 


//InitAgent(10000); 




txn = null; 

addActionListener(this); 


// Disable Transaction 


//Initialize Hash Maps 
tsStringMap = new HashMapO; 
tsBooleanMap = new HashMap(); 
tsIntegerMap = new HashMapO; 
tsFloatMap = new HashMapO; 
tsLongMap = new HashMap(); 
tsDoubleMap = new HashMapO; 
tsQueueMap = new HashMap () ; 
tsStackMap = new HashMapO ; 
tsLinkListMap = new HashMap(); 
tsHashMap = new HashMap{); 


/** look for the Jini/Space and test whether the interface is functioning 
©return <tt>true</tt> if agent is successfully initialized. */ 

public boolean InitAgent(long timeout) 

{ 

System.out.printIn("Security Policy : 

System.getProperty{"java.security.policy")); 

Systern.out.println("Space Name 

System.getProperty{"outrigger, spacename")); 

System.out.printIn("Server Codebase : 

System.getProperty{"j ava. rmi.server.codebase")); 

System.out.printIn{"Lookup URL 

System.getProperty("com.sun.jini.lookup.locator")); 

Sy stem.out.printIn{"Lookup groups : 

System.getProperty( "com. sun. j ini. lookup, groups") ) ; 

space = null; 
txnMgr = null; 
try{ 

if( ServiceAccessor.getLocator( timeout) != null){ 

space = ServiceAccessor.getSpace(getAgentSpaceName()) ; 
txnMgr = ServiceAccessor.getManager(); 
if(space == null || txnMgr == null) 
return false; 
else 

return true; 

} 

} catch (Exception e){ 
e.printStackTrace(); 

} 

return false; 

} 

public void TerminateAgent() 

{ 

Iterator it; 

for (it=tsStringMap.keyset().iterator(); it.hasNext{); ) { 

^ removeID( TS_STRING, (String) it.nextO); 

for (it=tsBooleanMap.keySet0.iterator 0 ; it.hasNext0; ) { 

^ removelD( TS_BOOLEAN,(String) it.next()); 

for (it=tsIntegerMap.keyset 0.iterator(); it.hasNext(); ) { 

^ removelD( TS_INTEGER,(String) it.next()); 

for (it=tsFloatMap.keySet0 .iterator(); it.hasNext(); ) { 
removelD( TS^FLOAT,(String) it.next()); 

} 

for (it=tsLongMap.keyset().iterator{); it.hasNext(); ) { 

^ removelD( TS_LONG, (String) it.nextO); 
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for {it=tsDoubleMap.keyset().iterator0; it.hasNext(); ) { 
removeID( TS_D01JBLE, (String) it.nextO); 

} 

for (it=tsQueueMap.keyset 0.iterator(); it.hasNextO; ) { 
removeID{ TS_QUEUE, (String) it.nextO); 

} 

for (it=tsStackMap.keyset 0-iterator 0; it.hasNextO; ) { 
removelD( TS_STACK,(String) it.next{)); 

} 

for (it=tsHashMap.keyset0.iterator0; it.hasNextO; ) { 
removelD( TS_HASH, (String) it.next O); 

} 

//System.runFinalizersOnExit(0); 

System.exit (0) ; 


/** returns the spaceAction handle 

* ©return <tt>null</tt> if space action handle is invalid. */ 

public SpaceActionHandler getActionHandler(){ 
return this; 

> 

/** start transaction manager; transaction handle will remain valid 

* for a maximum of 5 minutes (Default setting) 

* ©return <tt>false</tt> if transaction manager false to start. */ 
public boolean startTransactionO{ 

if(txnMgr != null){ 

Transaction.Created trc = null; 
try { 

trc = TransactionFactory.create(txnMgr/ 300000); 
txn = trc.transaction; 

return true; 

} catch (Exception e) { 

System.err.println("Could not create transaction " + e); 
return false; 

} 

}else 

return false; 

} 

/** returns the transaction handle; trauisaction manager must be 

* initialized and started 

* ©return <tt>null</tt> if transaction handle is invalid. */ 

public Transaction getTransaction(){ 
return txn; 

} 


/** returns the current state of transaction handle 

* ©return <tt>true</tt> if transaction handle is valid. */ 
public boolean isTransactionStarted(){ 

if(txn != null) 
return true; 
else 

return false; 

} 

/** aborts the current transaction; all the commands issued with 

* transaction after the start transaction will be rolled back. 

* ©return <tt>t 2 rue</tt> if transaction is successfully aborted. */ 
public boolean abortTransaction(){ 

try { 

txn.abort(); 
txn = null; 
return true; 

} catch (Exception e) { 
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return false; 

> 

} 

/** closes the current transaction; all the commands issued with 

* transaction after the start transaction will become active. 

* ©return <tt>true</tt> if transaction is successfully closed. */ 

public boolean closeTransaction(){ 
try { 

txn. commit {) ; 
txn = null; 
return true; 

> catch (Exception e) { 
return false; 

} 

} 

/** update the transaction handle in TSObject 

* ©pararn type the type of entry to create. E.g Entryinteger 

* ©param id a ID that identifies this entry 

* ©return <tt>true</tt> if entry is successfully created. */ 
public boolean updateTransactionHandle(int type. String id){ 

TSBase obj = (TSBase) getTSObject(type, id); 
if(obj == null) 
return false; 

obj .setTransactionHandler(txn); 
return true; 

} 


//***********•****★★★*★**★*•********★*★******★*•*****★*************★*******■*** 
//★** System Property Methods 
★ * * 

//***★*******•*******★***********************★******★********************★** 

/** Set Agent Security Policy path and filename*/ 
public void setAgentSecurityPolicy(String str){ 

System.setProperty("java.security.policy",str); 

} 

/** Returns Agent Security Policy path and filename*/ 
public String getAgentSecurityPolicy(){ 

return System.getProperty("java.security.policy"); 

} 

/** Set Agent Space Name */ 

public void setAgentSpaceName(String str){ 

System.setProperty("outrigger.spacename",str); 

} 

/** Returns Agent Space Name */ 
public String getAgentSpaceName0{ 

return System.getProperty("outrigger.spacename"); 

} 

/** Set Agent Server Codebase */ 

public void setAgentServerCodebase(String str){ 

System.setPropertyC* java.rmi.server.codebase", str) 

} 

/** Returns Agent Server Codebase */ 
public String getAgentServerCodebase(){ 

return System.getProperty( "java, rmi. server, codebase") ; 

} 

/** Set Agent Lookup Group */ 
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public void setAgentLookupGroup(String str){ 

Systein.setProperty ("com. sun. jini .lookup.groups", str) ; 

} 

/** Returns Agent Lookup Group */ 
public String getAgentLookupGroup{){ 

return System.getProperty("com.sun.jini.lookup.groups"); 

} 

/** Set Agent Lookup URL */ 
public void setAgentLookupURL(String str){ 
if(str != null || str.length() > 0) 

System.setProperty("com.sun.jini.lookup.locator",str); 

} 

/** Returns Agent Lookup URL */ 
public String getAgentLookupURL(){ 

return System.getProperty("com.sun.jini.lookup.locator"); 

} 


//***★*★*■*****★******■****★**★**************************★**★**************** 

// IDs 

* * * *• 

//*******************★******■★***★**********★******************************* 

/** Create a new entry in agent 

* @param type the type of entry to create. E.g Entryinteger 

* @param id an unique ID that identifies this entry 

* ©return <tt>true</tt> if entry is successfully created. */ 

public boolean createlDdnt type, String id) { 
switch(type){ 

case TS_BOOLEAN: 

if(!tsBooleanMap.containsKeyCid)){ 

TSBoolean ts = new TSBoolean(space,this,id); 
tsBooleainMap.put (id, ts); 
return true; 

} 

break; 

case TS_INTEGER: 

if(!tsIntegerMap.containsKey(id)){ 

TSInteger ts = new TSInteger(space,this,id); 
tsIntegerMap.put{id,ts); 
return true; 

} 

break; 

case TS_FLOAT: 

if(!tsFloatMap.containsKey(id)){ 

TSFloat ts = new TSFloat(space,this,id); 
tsFloatMap.put(id,ts); 
return true; 

} 

break; 

case TS_LONG: 

if(!tsLongMap.containsKey(id)){ 

TSLong ts = new TSLong{space,this,id); 
tsLongMap.put (id, ts) ,- 
return true; 

} 

break; 

case TS_DOUBLE: 

if(itsDoubleMap.containsKey(id)){ 

TSDouble ts = new TSDouble{space,this,id); 
tsDoubleMap.put(id,ts); 
return true; 

} 
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break; 

case TS_STRING: 

if(!tsStringMap.containsKey(id)){ 

TSString ts = new TSString(space,this,id); 
tsStringMap.put(id,ts); 
return true; 

} 

break; 

case TS_QUEUE: 

if(!tsQueueMap.containsKey(id)){ 

TSQueue ts = new TSQueue(space,this,id,100); 
tsQueueMap-put(id,ts); 
return true; 

} 

break; 

case TS_STACK: 

if{itsStackMap.containsKey(id)){ 

TSStack ts = new TSStack(space,id); 
tsStackMap.put(id,ts); 
return true; 

} 

break; 

case TS^LINKLIST: 
break; 

case TS_HASH: 

if(ItsHashMap.containsKey(id)){ 

TSHash ts = new TSHash(space,this,id); 
tsHashMap.put(id,ts); 
return true; 

} 

break; 

} 

return false; 

} 

/** Remove an existing TSString ID */ 
public boolean removeID(int type. String id){ 
switch (type) { 

case TS_BOOLEAN: 

if(tsBooleanMap.containsKey(id)){ 

TSBoolean ts = (TSBoolean) tsBooleanMap.get(id) 
ts.stopEvent(); 
tsBooleanMap.remove(id); 
return true; 

} 

break; 

case TS_INTEGER: 

if(tsIntegerMap.containsKey(id)){ 

TSInteger ts = (TSInteger) tsIntegerMap.get(id) 
ts.StopEvent{); 
tsIntegerMap. remove (id) ; 
return true; 

} 

break; 

case TS_FLOAT: 

if(tsFloatMap.containsKey(id)){ 

TSFloat ts = (TSFloat) tsFloatMap.get(id); 
ts.StopEvent 0; 
tsFloatMap.remove(id); 
return true; 

} 

break; 

case TS_LONG: 

if(tsLongMap.containsKey(id)){ 

TSLong ts = (TSLong) tsLongMap.get(id); 
ts.StopEvent{); 
tsLongMap.remove(id); 
return true; 
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} 

break; 

case TS_DOUBLE: 

if(tsDoubleMap.containsKey(id)){ 

TSDouble ts = (TSDouble) tsDoubleMap.get(id); 
ts.stopEvent{); 
tsDoubleMap.remove (id) ; 
return true; 

} 

break; 

case TS^STRING: 

if(tsStringMap.containsKey(id)){ 

TSString ts = (TSString) tsStringMap.get(id); 
ts.StopEvent(); 
tsStringMap. remove (id) ; 
return true; 

} 

break; 

case TS_QUEUE: 

if(tsQueueMap.containsKey(id)){ 
tsQueueMap.remove(id); 
return true; 

} 

break; 

case TS_STACK: 

if(tsStackMap.containsKey{id)){ 
tsStacJds^ap. remove (id); 
return true; 

} 

break; 

case TS_LINKLIST: 
break; 

case TS_HASH: 

if(tsHashMap.containsKey(id)){ 

TSHash ts = (TSHash) tsHashMap.get(id); 
ts.StopEvent(); 
tsHashMap. remove (id); 
return true; 

> 

break; 

} 

return false; 

} 


/** Remove an existing TSString ID */ 
public Object getTSObject(int type. String id){ 
switch(type){ 

case TS_BOOLEAN: 

if (tsBooleanMap. containsKey (id)) 
retum tsBooleanMap.get (id) ; 
break; 

case TS_INTEGER: 

if(tsIntegerMap.containsKey(id)) 
return tsIntegerMap.get(id) ; 
break; 

case TS_FLOAT: 

if(tsFloatMap.containsKey(id)){ 
return tsFloatMap.get(id) ; 

} 

break; 

case TS_LONG: 

if(tsLongMap.containsKey(id)){ 
return tsLongMap.get(id); 

} 

break; 

case TS_DOXJBLE: 

if(tsDoubleMap.containsKey(id)){ 
return tsDoubleMap.get(id); 

} 
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break; 

case TS^STRING: 

if(tsStringMap.containsKey(id)} 
return tsStringMap.get(id); 
break; 

case TS_QUEUE: 

if(tsQueueMap.containsKey(id)) 
return tsQueueMap.get{id); 
break; 

case TS^STACK: 

if(tsStackMap.containsKey(id)) 
return tsStackMap.get(id); 
break; 

case TS^LINKLIST: 
break; 

case TS^HASH: 

if (tsHashMap. containsKey (id)) 
return tsHashMap.get(id); 
break; 
default: 

break; 


} 

System.out,printIn("Cannot find TSClass! Type:" +type+ " ID:" + id) 
return null; 


/** Creates a new TSString ID */ 

public boolean cleanTSClass(int type. String id){ 
switch (type) { 

case TS_BOOLEAN: 

if(tsBooleanMap.containsKey(id) ){ 

TSBoolean ts = (TSBoolean) tsBooleanMap.get(id); 
ts.cleanSpace{); 
return true; 

) 

break; 

case TS_INTEGER: 

if (tsIntegerMap. containsKey (id)) { 

TSInteger ts = (TSInteger) tsIntegerMap.get(id); 
ts.cleanSpace(); 
return true; 

} 

break; 

case TS_FLOAT: 

if(tsFloatMap.containsKey(id)){ 

TSFloat ts = (TSFloat) tsFloatMap.get(id); 
ts.cleanSpace(); 
return true; 

} 

break; 

case TS_LONG: 

if(tsLongMap.containsKey(id)){ 

TSLong ts = (TSLong) tsLongMap.get(id) ; 
ts.cleanSpace(); 
return true; 

} 

break; 

case TS_DOUBLE: 

if(tsDoubleMap.containsKey(id)){ 

TSDouble ts = (TSDouble) tsDoubleMap,get(id); 
ts.cleanSpace(); 
return true; 

} 

break; 

case TS_STRING: 

if(tsStringMap,containsKey(id)){ 

TSString ts = (TSString) tsStringMap.get(id); 
ts.cleanSpace(); 
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return true; 


} 

break; 

case TS_QUEUE: 

if(tsQueueMap.containsKey(id)){ 

//TSQueue ts = (TSQueue) tsQueueMap.get(id); 

//ts.cleanSpace(); 
return true; 

} 

break; 

case TS_STACK: 

if(tsStackMap.containsKey{id)) { 

TSStack ts = (TSStack) tsStackMap.get(id); 

//ts.cleanSpace(); 
return true; 

} 

break; 

case TS^LINKLIST: 

break; 

case TS_HASH: 

if(tsHashMap.containsKey(id)){ 

TSHash ts = (TSHash) tsHashMap.get(id); 

//ts.cleanSpace(); 
return true; 

} 

break; 

} 

System.out.println( "Cannot find TSClass! Type:" +type+ " ID:" + id) 
return false; 

} 


/** Returns all TSString IDs created */ 
public String getTSClassIDs(int type){ 
Map map = nul1; 
switch(type){ 

case TS^BOOLEAN: 

map = tsBooleanMap; 
break; 

case TS_INTEGER: 

map = tsIntegerMap; 
break; 

case TS_FLOAT: 

map = tsFloatMap; 
break; 

case TS^LONG: 

map = tsLongMap; 
break; 

case TS_DOUBLE: 

map = tsDoubleMap; 
break; 

case TS_STRING: 

map = tsStringMap; 
break; 

case TS_QUEUE: 

map = tsQueueMap; 
break; 

case TS^STACK: 

map = tsStackMap; 
break; 

case TS_LINKLIST: 

map = tsIntegerMap; 
break; 

case TS_HASH: 

map = tsHashMap; 
break; 

} 
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if (map != null){ 

String tmpStr = null; 
int i =0; 

for (Iterator it=map.keyset().iterator() ;it.hasNext(); ) { 
if(tinpStr == null) 

tmpStr = (String) it.nextO; 

else 

tmpStr = tmpStr + + it.nextO; 

//print ('■ Key[''+ i++ + "] -> " + tmpStr); 

} 

return tirpStr; 

}else 

return null; 


//*****★★**■*★★**********★***★***★****★★*********★***★***★****•************** 
// *** Miscellaneous Methods 

* ★** 

//****.*******************.*.*.****.*****************************^*************^ 

public void actionPerformed(ActionEvent e){ 

print ("action ID :[" + e.getIDO + "] Command: [" + e, getActionCommandO + 

} 


public synchronized void addActionListener(ActionListener 1) { 
pushListeners.addElement(1); 

} 

public synchronized void removeActionListener(ActionListener 1) { 
pushListeners.removeElement(1); 

} 

public void fireAction(int entryType, String entrylD) { 

Vector targets; 

synchronized (this) { 

targets = (Vector) pushListeners.clone(); 

} 

ActionEvent actionEvt = new ActionEvent(this, entryType, entrylD); 
for (int i = 0; i < targets.size(); i++) { 

ActionListener target = (ActionListener)targets.elementAt(i); 
target.actionPerformed(actionEvt); 

//print("FireAction triggered!"); 

} 


public void print(String str){ 
System, out .println (str) ; 

} 


public int getTSType(String type){ 

if{ type.compareTo("BOOLEAN") == 0) 
return TS_BOOLEAN; 

else if( type.compareTo("INTEGER") == 0) 
return TS_INTEGER; 

else if( type.compareTo("FLOAT") == 0) 
return TS_FLOAT; 

else if( type.compareTo("LONG") == 0) 
return TS_LONG; 

else if ( type. corrpareTo ( "DOUBLE") == 0) 
return TS_DOUBLE; 

else if( type.compareTo("STRING") == 0) 
return TS^STRING; 

else if( type.compareTo("QUEUE") == 0) 
return TS_QUEUE; 

else if( type.compareTo("STACK") == 0) 
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return TS_STACK; 

else if ( type.conpareTo (’’LINKLIST”) == 
return TS^LINKLIST; 
else if{ type.compareTo("HASH") == 0) 
return TS^HASH; 
else 

return 0; 

} 


public void SearchTSClassIDs() 

{ 

System.out.println("Start Search"); 
startTransaction{); 
searchSpace(TS_STRING); 
searchSpace(TS_INTEGER); 
searchSpace(TS_LONG); 
searchSpace(TS_DOUBLE); 

abortTransaction(); 

} 

private void searchSpace(int type) 

{ 

boolean breakLoop = false; 
do{ 

try{ 

switch (type) { 
case TS^BOOLEAN: 

EntryBoolean testO = (EntryBoolean) space.takelfExists(new 

EntryBoolean(),txn,1000); 

createlD(type, testO.entrylD); 
break; 

case TS^INTEGER:. 

Entryinteger testl = (Entryinteger) space.takelfExists(new 

Entryinteger(),txn,1000); 

createID(type, testl.entrylD); 
break; 

case TS_FLOAT: 

EntryFloat test2 = (EntryFloat) space.takelfExists(new 

EntryFloat(),txn,1000); 

createlD(type, test2.entrylD); 
break; 

case TS^LONG: 

EntryLong test3 = (EntryLong) space.takelfExists(new 

EntryLongO , txn, 1000) ; 

createlD(type, test3.entiylD); 
break; 

case TS_DOUBLE: 

EntryDouble test4 = (EntryDouble) space, takelf Exists { new EntryDo\able {) 

,txn,1000); 

createlD(type, test4.entrylD); 
break; 

case TS^STRING: 

Entrystring tests = (EntryString) space.takelfExists(new 

EntryString(),txn,1000); 

createlD(type, tests.entrylD); 
break; 

case TS_QUEUE; 

EntryQueueltem test6 = (EntryQueueltem) space.takelfExists(new 

EntryQueueItem(),txn,1000); 

createlD(type, test6.entrylD); 
break; 

case TS^STACK: 

//EntryStack test = (EntryStack) space.takelfExists((EntryStack) 

template,null,1000); 

//createlD(type, test.entrylD); 
break; 

case TS^LINKLIST: 
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//test = space.takelfExists((EntryLinkList) tenplate^null^lOOO); 
//createID(type.(EntryLinkList) test.entrylD); 
break; 

case TS^HASH: 

EntryHash test? = (EntryHash)space.takelfExists(new 

EntryHash{),txn,1000); 

createlD{type, test?.entrylD); 
break; 

> 

}catch (Exception e){ 
breakLoop = true,- 

} 

}while(breakLoop == false); 

} 

} 


I 


I 
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2. ServiceFinder.java 

package tuplespace.core; 


import net-jini.core.lookup.*; 

import net.jini.discovery.*; 

irrport net-j ini .core, entry. *; 

import net.jini.lookup.entry.Name; 

irrport com. sun. jini .mahout,Locator; 

import com.sun.jini.outrigger.Finder; 

import com.sxm.jini.outrigger.DiscoveryLocator; 

import java.rmi-Remote; 
iirport java.rmi .RemoteException; 
import java.rmi.AccessException; 
irrport java.util.Iterator; 

/ * * 

* A <code> ServiceFinder </code> implements the 

* methods needed locate a service in a Jini(tm) Lookup service. 

* 

* @author Kin Boon Kwang 

* @version 1.0/ 01 October 2000 
*/ 

public class ServiceFinder extends Finder { 

private ServiceRegistrar lookup; 
private int retry; 

private static final boolean DEBUG = false; 
private static final int MAX__DISCOVERY_RETRY = 10; 
private static final byte PACKET_TTL = 100; 

//Allow us to easily choose whether or not we want 
//to use the supplied means of locating the lookup 
//within the djinn. 


* Create a new <code>LookupFinder</code> object 
*/ 

public ServiceFinder() { 

} 

/** 

* Using the Jini lookup service returned by <code>locator</code> 

* find the service registered with a 

* <code>net.jini.lookup.entry.Name</code> attribute who's value 

* is <code>name</code>. If no service is registered under the 

* specified name retry xintil such a service appears. <p> This 

* method returns null if the lookup service can not be contacted. 

*/ 

public Object find {Locator locator/ String name) { 

Object titpobj = null; 

try { 

if (!(locator instanceof DiscoveryLocator)) 

throw new ClassCastException("LookupFinder: find: " + 

"locator must be a LookupLocator"); 

//by casting to ServiceRegistrar here/ we 
//are iirplicitly checking if what is eventually 
//returned by findO is really an instance of 
//ServiceRegistrar. 

ServiceRegistrar registrar = (ServiceRegistrar)locator.locate(); 

Entry[] attrs = new Entry[1]; 

Name n = new Name () ; 
n.name = name; 
attrs10] = n; 
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ServiceTemplate tmpl = 

new ServiceTemplate(null, null, attrs); 

if (DEBUG) { 

System.out.printIn("LookupFinder: find: name = ” + name); 
System.out.printIn("LookupFinder: find: registrar = " + 

registrar); 

System.out.printIn("LookupFinder: find: tmpl = " + tmpl); 

} 

retry = 0; 
do { 

tmpobj = registrar.lookup(tmpl); 
if {tmpobj == null) { 
try { 

System.out.println(•'waiting for " + name); 
Thread.sleep(2000); 

} catch (Exception te) { 

} 

} 

retry++; 

} while (tmpobj == null && retry <10); 

} catch (Exception e) { 

System.out.println("LookupLocator: find: " + e.getMessageO); 
e.printStackTrace(); 

} 

System.out .println ("found " + name + " = " + tmpobj); 
return tmpobj; 

} 

} 
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3. ServiceAccessor.java 

package tuplespace.core; 


irrport tuplespace. services - AgentServiceInterf ace ; 

import j ava.rmi .*; 

import java.awt.event; 

iitport ne t. j ini . spac e. JavaSpac e; 

inport net.jini.core.transaction.server.TransactionManager; 
irrport com.sun.jini.mahalo.TxnManagerlmpl; 

inport com.sun.jini.mahout.binder.RefHolder; 
inport com.sun.jini.mahout-Locator; 
inport com.sun.jini.outrigger.Finder; 
import com. sun.jini.*; 

/ * * 

* The <code>ServiceAccessor</code> class implements the methods for 

* registering the Se 2 rvices 

* 

* ©author Kin Boon Kwang 

* ©version l.Oy 01 October 2000 
*/ 

public class ServiceAccessor implements java.io.Serializable{ 
private static Locator locator; 

public static Locator getLocator( long lookupTimeout){ 
try { 

if (System.getSecurityManagerO == null) { 

System. setSecurityManager( new RMISecurityManager ()); 
System.out.println(" Running RMISecurity Manager"); 

} 

locator = new com.sun.jini.outrigger.DiscoveryLocator(lookupTimeout) 
return locator; 

} catch (Exception e) { 
locator = null; 

System.err.println(e-getMessage()); 

} 

return null; 

} 

public static JavaSpace getSpaceO { 
return getSpace("JavaSpaces"); 

} 

public static JavaSpace getSpace(String name) { 
try { 

if (System.getSecurityManager() == null) { 

System. setSecurityManager( new RMISecurityManager()); 

System, out. print In (" Rvinning RMISecurity Manager"); 

} 

if (System.getProperty("com.sun.jini.use-registry") == null) 

{ 

if(locator != null){ 

Finder finder = new ServiceFinder(); 
return (JavaSpace)finder.find(locator, name); 

} 

} else { 

RefHolder rh = (RefHolder)Naming.lookup(name); 
return (JavaSpace)rh.proxy{); 

} 

} catch (Exception e) { 

System, err.println(e.getMessage{)); 




} 

return null; 

> 

public static TransactionManager getManagerO { 

return getManager(com.sun.jini.mahalo.TxnManagerlmpl.DEFAULT_NAME) 

} 

public static TransactionManager getManager(String name) { 
try { 

if (System.getSecurityManager() == null) { 

System.setSecurityManager( new RMISecurityManager()); 
System.out.printIn{" Running RMISecurity Manager”); 

} 

if (System.getProperty("com.sun.jini.use.registry") == null) 

{ 

if(locator != null){ 

Finder finder = new ServiceFinder(); 

return (TransaetionManager)finder.find(locator, name); 

} 

} else { 

RefHolder rh = (RefHolder)Naming.lookup(name); 
return (TransactionManager)rh.proxy(); 

} 

} catch (Exception e) { 

System, err.println(e.getMessage()); 

} 

return null; 

} 

} 
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4. SpaceEventRegistration.java 

package tuplespace.core; 


import tuplespace.entries.*; 
import net.jini.core.transaction.*; 

j*-k 

* The <code>SpaceEventRegistration</code> class implements the methods for 

* for registering with Space Service to monitor new entries written into 

* the space. 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 
*/ 

public interface SpaceEventRegistration 

{ 

public abstract boolean startEventO; 

public abstract boolean startEventl(SpaceActionHandler spaceAction); 
public abstract boolean startEvent2(SpaceActionHandler spaceAction, long lease ); 
public abstract boolean startEventS(SpaceActionHandler spaceAction, long lease , 
Transaction txn); 

public abstract boolean stopEventO; 

} 


TSConstants.j ava 
package tuplespace.core; 


public interface TSConstants { 

public static final int TS_INTEGER = 5000; 
public static final int TS_FLOAT = 5001; 
public static final int TS_LONG = 5002; 
public static final int TS_DOUBLE = 5003; 
public static final int TS_STRING = 5004; 
public static final int TS_QUEUE = 5005; 
public static final int TS_STACK = 5006; 
public static final int TS_LINKLIST = 5007; 
public static final int TS_HASH = 5008; 


public static final int TS_BOOLEAN = 5009; 

} 
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5. TSBasejava 

package tuplespace.core; 

irrport tuplespace.entries.*; 

inport net.jini.space.JavaSpace; 

irrport net .j ini .core, entiry. Entry; 

import net.jini.core.lease.Lease; 

import net.jini.core.transaction.*; 

irrport net. j ini . core. event. EventRegi stration ; 


/** 

* The <code>TSBase</code> class implements the methods for setting the 

* attribute of entry. Every entry handler will inherit this class 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 
*/ 

public class TSBase implements java.io.Serial!table{ 
protected JavaSpace spacer- 

protected long writeLeaseTime, updateLeaseTime, notifyLeaseTime; 
protected long readTimeOut, takeTimeOut; 
protected String entrylD; 

protected EventRegistration eventRegistration; 
protected SpaceActionHandler spaceAction; 
protected Transaction transaction; 
protected boolean result; 

public TSBase() { 

System.out-println{"TSBase Constructor"); 

writeLeaseTime = Lease.FOREVER; 

updateLeaseTime = Lease.FOREVER; 

notifyLeaseTime =10000; //I minute 

readTimeOut = Long.MAX_VALUE; 

takeTimeOut = Long.MAX_VALUE; 

transaction = null; 

eventRegistration = null; 

spaceAction = null; 

space = null; 

result = false; 

} 

public void initTSBase(JavaSpace space, SpaceActionHandler spaceAction, String 

entrylD) 

{ 

this.space = space; 

this.entrylD = entrylD; 

this.spaceAction = spaceAction; 

} 

//*** Change Entry Setting 
* ★ 

//*★★★********★***★*****★**********.**★★**■*********★★★★**★****★*★** 

/** set space 

* ©param space JavaSpace handle */ 
public void setJavaSpace(JavaSpace space){ 

this.space = space; 

} 

/** set action listener 

* ©param spaceAction the class that irrplements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. */ 

public void setSpaceActionHandler( SpaceActionHandler spaceAction){ 
this.spaceAction = spaceAction; 

} 

/** set action listener 
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* @parain spaceAction the class that implements the actionPerformed{ActionEvent e) 

* method; called when remote event is raised. */ 
public void setTransactionHandler( Transaction trans){ 

this.transaction = trans; 

} 

public Transaction getTransactionHandler(){ 
return this.transaction; 

} 

/** set write lease time 

* @param leaseTime the amount of time for entry to remain valid in space; 

* used when writing entry to space */ 
public void setWriteLeaseTime(long leaseTime){ 

this.writeLeaseTime = leaseTime; 

} 

/** get write lease time 

* ©return the current time setting for entry to remain valid in space*-/ 
piablic long getWriteLeaseTime () { 

return this.writeLeaseTime; 

} 

/** set update lease time 

* ©param leaseTime the amount of time for entry to remain valid in space; 

* used when updating an existing entry in space */ 
public void setUpdateLeaseTime(long leaseTime){ 

this.updateLeaseTime = leaseTime; 

} 

/** get update lease time 

* ©return the current time setting for entry to remain valid in space*/ 
public long getUpdateLeaseTime{){ 

return this.updateLeaseTime; 

} 

/** set read time out 

* ©param timeOut the maximum waiting time when reading an entry from space*/ 
public void setReadTimeOut{long timeOut){ 

this.readTimeOut = timeOut; 

} 

/** get read time out 

* ©return the current waiting time setting for reading an entry from space*/ 
public long getReadTimeOut{){ 

return this.readTimeOut; 

} 

/** set take time out 

* ©param timeOut the maximum waiting time when taking an entry from space*/ 
public void setTakeTimeOut(long timeOut){ 

this.takeTimeOut = timeOut; 

} 

/** get take time out 

* ©return the current waiting time setting for taking an entry from space*/ 
public long getTakeTimeOut(){ 

return this.takeTimeOut; ♦ 

} 

/** For debugging purposes */ 
protected void print(String str){ 

System.out-printIn(str); 

} 

public void setResult(boolean value){ 
result = value; 

} 
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public boolean getResult(){ 
return result; 

} 

6. TS Constants 

package tuplespace.core; 

public interface TSConstants { 

public static final int TS_INTEGER = 5000 

public static final int TS_FLOAT = 5001 

public static final int TS_LONG = 5002 

public static final int TSJOUBLE = 5003 

public static final int TS_STRING = 5004 

public static final int TS_QUEUE = 5005 

public static final int TS_STACK = 5006 

public static final int TS_LINKLIST = 5007 

public static final int TS_HASH = 5008; 
public static final int TS_BOOLEAN = 5009; 

} 
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TSBoolean.java 

package tuplespace.core; 

iirport tuplespace.entries. *; 

import tuplespace.entries.SpaceActionHandler; 

iirport net.jini.space.JavaSpace; 

iirport net. j ini. core, entry. Entry; 

iirport net. j ini. core. lease. Lease; 

import net.jini.core.transaction.*; 

iirport net.jini.core.event.EventRegistration; 

/ * * 

* The <code>TSBoolean</code> class implements the methods for reading, writing, 

* updating, notifying and retrieving EntryBoolean entry from space. Every 

* EntryBoolean entry in the space is identified by an unique ID (entrylD). 

* 

* A subclass that iirplements the SpaceActionHandler interface has to loaded 

* during initialization if remote event notification is used. 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 

* ©see EntryBoolean 
*/ 

public class TSBoolean extends TSBase iirplements java. io.Serializable, 
SpaceEventRegistration, TSConstants{ 
private EntryBoolean entry, entryTenplate; 

/** Constructor for TSBoolean 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerfozmed(ActionEvent e) 

* method, called when remote event is rised. 

* ©param entrylD the unique ID that identifies the Boolean Entry 
*/ 

public TSBoolean(JavaSpace space, SpaceActionHandler spaceAction, String entrylD) ( 
super(); 

initTSBoolean(space, spaceAction, entrylD); 

} 

/** initialize TSBooleam 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerfozTned(ActionEvent e) 

* method; called when remote event is raised. 

* ©param entrylD the unique ID that identifies the Boolean Entry 

* ©return <tt>true</tt> if internal states are sucessfully reinitialized. 

*/ 

public boolean initTSBoolean(JavaSpace space, SpaceActionHandler spaceAction, String 
entrylD) 

{ 

try{ 

initTSBase(space, spaceAction, entrylD); 
entry = new EntryBoolean(entrylD); 
entryTenplate = new EntryBoolean(entrylD); 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

/** Remove all existing entries from space */ 
public void cleanSpaceO 
{ 

cleanSpacel(null); 

} 

/** Remove all existing entries from space 
* ©param txn a valid transaction handle */ 
public void cleanSpacel(Transaction txn) 

{ 

Object test; 
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do{ 

try{ 

test = space.takeIfExists(entryTemplate,txn,1000); 

//print("remove [" + entrylD + "] from space"); 

}catch (Exception e){ 
e-printStackTrace() ; 
test = null; 

} 

}while(test 1= null); 

} 

//**★*★******★********************★****★****★************★******** 
//*** Write Entry 

//******★★******★*****★******★*********★****************★********* 

/** Writes value to space 

* @param value the entry value (Boolean) 

* ©return <tt>true</tt> if entry is sucessfully written to space, */ 
public boolean writel(boolean value){ 

return writes( value, this.writeLeaseTime, null); 

} 

/** Writes value to space 

* ©param value the boolean value that is to be written to space 

* ©param lease the amo;ant of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean write2(boolean value, long lease){ 

return writes( value, lease, null); 


/★* Writes value to space 

* ©param value the boolean value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writes(boolean value, long lease. Transaction txn) { 

try{ 

entry = new EntryBo clean (this, entry ID, value) ; 
space, write (entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 


//**•******★*★***★★************★★*★*****★***********************★** 
//*** Update Entry 
* * ■*■ 

//**********★**********★**★******★***********★**********■********** 
/** Updates an existing entry value 

* ©param value the entry value (Boolean) to be updated 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 

public boolean updatel(boolean value) { 

return updates( value, this.updateLeaseTime, null); 

} 

/** Updates an existing entry value 

* ©param value the boolean value that is to be updated 

* ©param lease the amount of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean updates(boolean value, long lease) { 

return updates{ value, lease, null); 


/** Updates an existing entry value 

* ©param value the boolean value that is to be updated 
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* @param lease the amount of time entry is placed in space 

* @param txn a valid transaction handle, if transaction is involved 

* @retum <tt>t 2 rae</tt> if entry is sucessfully updated. */ 
public boolean updates(boolean value, long lease. Transaction txn) 

{ 

try{ 

cleanSpacel(txn); 

entry = new EntryBoolean(this.entrylD, value); 
space.write(entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace() ; 
return false; 

} 

} 


//****************★***************************★★************•****** 

//*** Read Entry 

★ ★ * 

//*********************★********★★***************************★**** 

/** Reads an entry value 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 
public boolean readIfExists() 

{ 

return readIfExists2(this.readTimeOut, null); 

} 

/** Reads an entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean readlfExistsl(long timeOut) 

{ 

return readIfExists2(timeOut, null); 

} 

/** Reads an entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean readIfExists2(long timeOut, Transaction txn) 

{ 

this.setResult(false); 
try{ 

entry = (EntryBoolean) space.readIfExists (entryTeirplate, txn, timeOut) 
if( entry J= null) 

{ 

this.setResult(true); 

return entry.entryBoolean.booleanValue(); 

> 

else 

return false,- 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 


//*** Take Entry 

* * * 
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/** Takes an entry value; entry will be removed from space 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 
public boolean takelfExists{) 

{ 

return takelfExistsi{this.takeTimeOut); 

} 

/** Takes an entry value; entry will be removed from space 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean takelfExistsl( long timeOut) 

{ 

return takelfExists2(timeOut, null); 

} 

/** Takes an entry value; entry will be removed from space 

* ©param timeOut the maximum waiting time when reading the entry 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean takelfExists2C long timeOut, Transaction txn) 

{ 

this.setResuit(false); 
try{ 

entry = (EntryBoolean) space. takelfExists (entryTeirplate, txn, timeOut); 
if( entry != null) 

{ 

this.setResult(true); 

return entry.entryBoolean.booleanValue () ; 

} 

else 

return false; 

} 

catch (Exception e){ 

e-printStackTrace{); 
return false; 

} 

} 


//***★****★*************★***************************************** 

//*** Notify 

* ★ * 

//**************★*****************★*★******************★**★******* 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventO 

{ 

return startEventS(this.spaceAction, this.notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventl(SpaceActionHandler spaceAction) 

{ 

return startEventB(spaceAction, this.notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed (ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amount of time for notification to remain active 
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* @retum <tt>true</tt> if notification is enabled. */ 

public boolean startEvent2(SpaceActionHandler spaceAction, long lease ) 

{ 

return startEventS(spaceAction, lease , null); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* @param spaceAction the class that implements the actionPerformed{ActionEvent e) 

* method; called when remote event is raised. 

* @param lease the amount of time for notification to remain active 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEventl(SpaceActionHandler spaceAction, long lease , Transaction 
txn) 

{ 

try{ 

// Remove earlier event notification 
if(eventRegistration != null) 

eventRegistration.getLease().cancel(); 

// Register new event notification 

SpaceEventListener listener = new SpaceEventListener(TS_BOOLEAN, entrylD, 
space, spaceAction) ; 

eventRegistration = space.notify(entryTemplate, txn, listener, lease, null); 
return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 

/** Stop notification 

* ©return <tt>true</tt> if notification is disabled. */ 
public boolean stopEvent(){ 

try{ 

if{ eventRegistration != null) 

{ 

eventRegistration.getLease{).cancel 0; 
eventRegistration = null; 

} 

return true; 

} 

catch (Exception e){ 
return false; 

} 

} 


//*★***★**★*********★*★**********★***★*********★************★****★ 
//*** Transaction Methods 
* * * 

//************************************★******★★★****************** 
/*★ Writes entry value with treinsaction 

* ©param value the boolean value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transWrite(boolean value, long lease) 

{ 

return writeS(value,lease,this.getTransactionHandler()); 

} 

/** Updates an existing entry value with transaction 

* ©param value the boolean value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 


197 



public boolean transUpdate(boolean value, long lease) 

{ 

return update3(value,lease,this.getTransactionHandler()); 

} 

/** Reads an entry value with transaction 

* (aparam timeOut the maximum waiting time when reading the entry from space 

* (aparam this. transaction must be a valid transaction handle 

* (areturn <tt>"Exception in method «"</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean transReaddong timeOut) 

{ 

return readIfExists2(timeOut, this.getTransactionHandler()); 

} 

/** Takes an entry value with transaction; entry will be removed from space 

* (Sparam timeOut the maximum waiting time when reading the entry 

* @param this. transaction must be a valid transaction handle 

* ©return <tt>"Exception in method !''</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean transTake( long timeOut) 

{ 

return takeIfExists2(timeOut, this.getTransactionHandler()); 

} 

} 
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7. TSDouble.java 

package fuplespace.core; 

import tuplespace.entries.*; 

iirport net.jini.space.JavaSpace; 

import net.jini.core.entry.Entry; 

import net.jini.core.lease.Lease 7 

import net.jini.core.transaction.*; 

import net.jini.core.event.EventRegistration; 

^ * 

* The <code>TSDouble</code> class implements the methods for reading, writing, 

* updating, notifying and retrieving EntryDouble entry from space. Every 

* EntryDouble entry in the space is identified by an unique ID (entrylD). 

* 

* A subclass that implements the SpaceActionHandler interface has to loaded 

* during initialization if remote event notification is used. 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 

* ©see EntryDouble 
*/ 


public class TSDouble extends TSBase implements java.io.Serializable, 
SpaceEventRegistration, TSConstants{ 
private EntryDouble entry, entryTeirplate; 

/** Constructor for TSDouble 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method, called when remote event is rised. 

* ©param entrylD the unique ID that identifies the Double Entry 
*/ 

public TSDouble(JavaSpace space, SpaceActionHandler spaceAction, String entrylD) { 
super(); 

initTSDouble(space, spaceAction, entrylD); 

} 

/** initialize TSDouble 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerfonned(ActionEvent e) 

* method; called when remote event is raised. 

* ©param entrylD the tinique ID that identifies the Double Entry 

* ©return <tt>true</tt> if internal states are sucessfully reinitialized. 

*/ 

public boolean initTSDouble(JavaSpace space, SpaceActionHandler spaceAction, String 
entrylD) 

{ 

try{ 

initTSBase(space, spaceAction, entrylD); 
entry = new EntryDouble (entrylD) ; 
entryTemplate = new EntryDouble(entrylD); 
eventRegistration = null; 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

/** Remove all existing entries from space */ 
public void cleanSpaceO 
{ 

cleanSpacel(null); 

} 

/** Remove all existing entries from space 
* ©param txn a valid transaction handle */ 
public void cleanSpacel(Transaction txn) 

{ 
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Object test; 
do{ 

try{ 

test = space.takeIfExists(entryTemplate,txn,1000); 
//print("remove [“ + entrylD + "] from space"); 

}catch (Exception e){ 
e.printStackTrace(); 
test = null; 

} 

}while(test != null); 


//*** Write Entry 


/** Writes value to space 

* @param value the entry value (Double) 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writel(double value) 

{ 

return writes( value, this.writeLeaseTime, null); 

} 

/** Writes value to space 

* ©param value the double value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean write2(double value, long lease) 

{ 

return writes ( value, lease, null) ,- 

} 

/** Writes value to space 

* ©param value the double value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writes(double value, long lease. Transaction txn) 

{ 

try{ 

entry = new EntryDouble (this. entrylD, value); 
space. write (entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 


//*******He****-k*-k*-k-k-k**i,ick***if*it*-tr***it*****tr*iric-k*ificie**ir******fr*ie** 

//*** Update Entry 
* * * 

//**************ic****ir*******ic*i,ifk***-k**ir*-k**it**itif*-k-k-k**-k*-ki,**ic-k*-k 
/** Updates an existing entry value 

* ©param value the entry value (Double) to be updated 

* ©return <tt>t3rue</tt> if ent2rY is sucessfully updated. */ 
public boolean updatel(double value) 

{ 

return updates( value, this.updateLeaseTime, null); 

} 

/** Updates an existing entry value 

* ©param value the double value that is to be updated 

* ©param lease the amount of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
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public boolean update2(double value, long lease) 

{ 

return updates( value, lease, null )7 

} 

/** Updates an existing entry value 

* (Sparam value the double value that is to be updated 

* (Sparam lease the amount of time entry is placed in space 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>tme</tt> if entry is sucessfully updated. */ 
public boolean updates(double value, long lease. Transaction txn) 

{ 

try{ 

cleanSpacel(txn); 

entry = new EntryDouble{this.entryID, value); 
space.write(entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false,- 

} 

} 


^^***.^************** ********************************************** 
//***• Read Entry 

* * * 

^^**************************************************************** 
/** Reads an entry value 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. *! 
public double readIfExists() 

{ 

return readIfExists2(this.readTimeOut, null); 

} 


/** Reads an entry value 

* ©param timeout the maximum waiting time when reading the entry from space 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. * / 

pxiblic double readlfExistsl (long timeOut) 

{ 

return readIfExists2(timeOut, null); 

} 

/** Reads an entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. *! 

piiblic double readIfExists2 (long timeOut, Transaction txn) 

{ 

this.setResult(false); 
tryC 

entry = (EntryDouble) space. readlfExists(entryTerrplate, txn, timeOut) 
if( entry != null) 

{ 

this.setResult(true); 

return entry.entryDouble.doubleValue(); 

} 

else 

return -I; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return -1; 

} 
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} 


//********************************yf********************^t*****iir**** 

J/*** Take Entry 

*★ * 

//Hr************************************.*************************** 

/** Takes an entry value; entry will be removed from space 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 
public double takelfExists() 

{ 

return takelfExistsl(this.takeTimeOut); 

} 

/** Takes an entry value; entry will be removed from space 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 

public double takelfExistsl( long timeOut) 

{ 

return takeIfExists2(timeOut, null); 

} 

/** Takes an entry value; entry will be removed from space 

* ©param timeOut the maximum waiting time when reading the entry 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 

public double takeIfExists2( long timeOut, Transaction txn) 

{ 

this.setResult(false); 
try{ 

entry = (EntryDouble) space. takelfExists (entryTenplate, txn, timeOut) 
if( entry != null) 

{ 

this.setResult(true); 

return entry.entryDouble.doubleValue(); 

} 

else 

return -1; 

} 

catch (Exception e){ 
e.printStackTrace(); 

return -1; 

} 

} 


//*******itir**-k-kif**-tf***if**ifk*ir*ici,’k-*r-kifit*if**if*i(ie*ic*^**-kieir******ir-kifki,it 

//*** Notify 

* * * 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventO 

{ 

return startEvent3(this.spaceAction, this.notifyLeaseTime, null ),- 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventl(SpaceActionHandler spaceAction) 

{ 

return startEventB(spaceAction, this.notifyLeaseTime, null ); 
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> 


/** start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* @param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* @param lease the amount of time for notification to remain active 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEvent2(SpaceActionHandler spaceAction, long lease ) 

{ 

return startEvent3(spaceAction, lease , null); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that inplements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amount of time for notification to remain active 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEventB(SpaceActionHandler spaceAction, long lease , Transaction 
txn) 

{ 

try{ 

// Remove earlier event notification 
if(eventRegistration != null) 

eventRegistration.getLease().cancel(); 

// Register new event notification 

SpaceEventListener listener = new SpaceEventListener(TS_DOUBLE, entrylD, 
space,SpaceAction); 

eventRegistration = space.notify(entryTemplate, txn, listener, lease, null); 
retum true; 

} 

catch (Exception e){ 

e.printStackTrace{); 
return false; 

} 

> 

/** Stop notification 

* ©return <tt>true</tt> if notification is disabled. */ 
public boolean stopEvent(){ 

try{ 

if( eventRegistration != null) 

{ 

eventRegistration.getLease().cancel(); 
eventRegistration = null; 

} 

return true; 

} 

catch (Exception e){ 
return false; 

} 

} 


//**************************************************************** 
II*** Transaction Methods 
★ * 

//*★****★*********★*★*************************************•**★★**** 
/** Writes entry value with transaction 

* ©param value the boolean value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param this. transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transWrite(double value, long lease) 

{ 

return write3(value,lease,this.getTransactionHandler()); 
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} 

/** Updates an existing entry value with transaction 

* @parain value the boolean value that is to be written to space 

* @parain lease the amount of time entry is placed in space 

* @param this.transaction must be a valid transaction handle 

* @return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transUpdate(double value, long lease) 

{ 

return updates (value,lease, this.getTransactionHandler{)) ,- 

} 

/** Reads an entry value with transaction 

* @param timeOut the maximum waiting time when reading the entry from space 

* @param this.transaction must be a valid transaction handle 

* @retum <tt>”Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 

public double transRead(long timeOut) 

{ 

return readIfExists2(timeOut, this.getTransactionHandler()); 

} 

/** Takes an entry value with transaction; entry will be removed from space 

* @param timeOut the maximum waiting time when reading the entry 

* @param this.transaction must be a valid transaction handle 

©return <tt>''Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 

public double transTake( long timeOut) 

{ 

return takeIfExists2(timeOut, this.getTransactionHandler()); 

} 


8 . 


TSLong.java 


package tuplespace.core; 

import tuplespace.entries; 

import net.jini.space.JavaSpace; 

import net. j ini. core, entiry. Entry ; 

import net.jini.core.lease.Lease; 

import net.jini.core.transaction.*; 

import net.jini.core.event.EventRegistration; 

* The <code>TSLong</code> class implements the methods for reading, writing, 

* updating, notifying and retrieving EntryLong entry from space. Every 

* EntryLong entry in the space is identified by an unique ID (entrylD) . 

* 

* A subclass that implements the SpaceActionHandler interface has to loaded 

* during initialization if remote event notification is used. 

* 

* ^author Kin Boon Kwang 

* ©version 1.0, 01 September 2000 

* ©see EntryLong 
*/ 


public class TSLong extends TSBase implements java.io.Serializable, 

SpaceEventRegistration, TSConstants{ 
private EntryLong entry, entryTemplate; 

/** Constructor for TSLong 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed{ActionEvent e) 

* method, called when remote event is rised. 

* ©param entrylD the unique ID that identifies the Long Entry 
*/ 

public TSLong{JavaSpace space, SpaceActionHandler spaceAction, String entrylD) { 
super(); 

initTSLong(space, spaceAction, entrylD); 

) 

/** initialize TSLong 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param entrylD the unique ID that identifies the Long Entry 

* ©return <tt>true</tt> if internal states are sucessfully reinitialized, 

*/ 

public boolean initTSLong(JavaSpace space, SpaceActionHandler spaceAction, String 
entrylD) 

{ 

try{ 

initTSBase(space, spaceAction, entrylD); 
entry = new EntryLong (entrylD) ; 
entryTemplate = new EntryLong(entrylD); 
eventRegistration = null; 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

/** Remove all existing entries from space */ 
public void cleanSpaceO 
{ 

cleanSpacel(null); 

} 

/** Remove all existing entries from space 
* ©param txn a valid transaction handle */ 
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public void cleanSpacel(Transaction txn) 

{ 

Object test; 
do{ 

try{ 

test = space.takeIfExists(entryTemplate,txn,1000); 

//print ("remove [" + entrylD + "] from space"); 

}catch (Exception e){ 
e.printStackTrace(); 
test = null; 

} 

}while(test != null); 

} 

//***********************.**********.**********.********************yf 

//*** Write Entry *** 

//**************************************************************** 


/** Writes value to space 

* @param value the entry value (Long) 

* @retum <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writeKlong value) 

{ 

return write3( value, this.writeLeaseTime, null); 

} 

/** Writes value to space 

* @param value the long value that is to be written to space 

* @param lease the amount of time entry is placed in space 

* @retum <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean write2(long value, long lease) 

{ 

return writes( value, lease, null); 

} 

/** Writes value to space 

* @param value the long value that is to be written to space 

* @param lease the amo\int of time entry is placed in space 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean write3(long value, long lease. Transaction txn) 

{ 

try{ 

entry = new EntryLong(this.entrylD, value); 
space, write (entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

> 


//**********************•*****★**************★★*************★******■ 
//*** Update Entry *** 

//★********★*★***************★★****************************★★***** 

/** Updates an existing entry value 

* ©pararn value the entry value (Long) to be updated 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean updateKlong value) 

{ 

return updates( value, this.updateLeaseTime, null); 

} 

/** Updates an existing entry value 

* ©param value the long value that is to be updated 

* ©param lease the amount of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
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public boolean update2(long value/ long lease) 

{ 

return update3{ value, lease, null); 

} 

/** Updates an existing entry value 

* @parain value the long value that is to be updated 

* @parain lease the amount of time entry is placed in space 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean updates(long value, long lease. Transaction txn) 

{ 

try{ 

cleanSpacel(txn); 

entry = new EntryLong(this.entryID, value); 
space.write(entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

) 

} 


//******★**********************★***★*****★****★******************* 

//*** Read Entry *** 

//***********************★**********★★****★*********************** 

/** Reads an entry value 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 
public long readifExists() 

{ 

return readifExists2(this.readTimeOut, null); 

} 

/** Reads an entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 

public long readifExistsl(long timeOut) 

{ 

return readifExists2(timeOut, null); 

} 

/** Reads an entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 

public long readifExists2(long timeOut, Transaction txn) 

{ 

this.setResult(false); 
try{ 

entry = (EntryLong) space .readifExists (entryTerrplate, txn, timeOut) ,- 
if( entry != null) 

{ 

this.setResult(true); 

return entry.entryLong.longValue(); 

} 

else 

return -1; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return -1; 

} 

} 
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//★*********yr**************iir**************************j^**********^ 

//*** Take Entry *** 

//************★******★**************★******★*****★**************** 

/** Takes an entry value; entry will be removed from space 

* ©return <tt>-l</tt> if entry is not available/ otherwise 

* the entry value. */ 

public long takelfExists() 

{ 

return takelfExistsl(this.takeTimeOut); 

} 

/** Takes an entry value; entry will be removed from space 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 

ptiblic long takelfExistsl { long timeOut) 

{ 

return takeIfExists2(timeOut, null); 

} 

/*♦ Takes an entry value; entJiry will be removed from space 

* ©param timeOut the maximum waiting time when reading the entry 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 

public long takeIfExists2{ long timeOut, Transaction txn) 

{ 

this.setResult(false); 
try{ 

entry = (EntryLong) space.takelfExists (entryTeirplate, txn, timeOut) ; 
if( entry != null) 

{ 

this. setResult (t 2 rue) ; 

return entry. entryLong. longValue () ; 

} 

else 

return -l; 

} 

catch (Exception e){ 
e.printStackTrace(); 

return -1; 

} 

} 


//*i^*****ic*******-k-k-k**-k*******ir*ifh*-kic*****i,ie*iticii-k-ki,-k-k***iti,ie*ic**1ricic 

//*** Notify *** 

//****■******★**•************************★****★****★**************** 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventO 

{ 

return startEventS(this.spaceAction, this.notifyLeaseTime, null ); 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventl(SpaceActionHandler spaceAction) 

{ 

return startEventS (spaceAction, this .notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 
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* that matches the entry ID is added into the space. 

* @parain spaceAction the class that irrplements the actionPerformed{ActionEvent e) 

* method; called when remote event is raised. 

* @param lease the amount of time for notification to remain active 

* @retum <tt>true</tt> if notification is enabled. */ 

public boolean startEvent2(SpaceActionHandler spaceAction, long lease ) 

{ 

return startEventS(spaceAction, lease , null); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* @param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* @param lease the amount of time for notification to remain active 

* @param txn a valid transaction handle, if transaction is involved 

* @retu 2 m <tt>true</tt> if notification is enabled. */ 

public boolean startEventB(SpaceActionHandler spaceAction, long lease , Transaction 
txn) 

{ 

try{ 

// Remove earlier event notification 
if(eventRegistration != null) 

eventRegiStration.getLease{).cancel(); 

// Register new event notification 

SpaceEventListener listener = new SpaceEventListener(TS_LONG, entrylD, 
space,SpaceAction); 

eventRegistration = space.notify(entryTemplate, txn, listener, lease, null); 
return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 

/** Stop notification 

* ©return <tt>true</tt> if notification is disabled. */ 
public boolean stopEventOC 

try{ 

if{ eventRegistration i= null) 

{ 

eventRegistration.getLease().cancel{); 
eventRegistration = null; 

} 

return true; 

} 

catch (Exception e){ 
return false; 

} 

> 


//***********★**★★****•***■*********★*****★**★*****■****•**********★** 
//*** Transaction Methods *** 

//******★****★***★*************★*★*************★**★****★***★****** 

/** Writes entry value with transaction 

* ©param value the long value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transWrite(long value, long lease) 

{ 

return write3(value,lease,this.getTransactionHandler()); 

} 

/** Updates an existing entry value with transaction 

* ©param value the long value that is to be written to space 

* ©param lease the amount of time entry is placed in space 
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* ©param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transUpdate(long value, long lease) 

{ 

return updates(value,lease,this.getTransactionHandler()); 

} 

/** Reads an entry value with transaction 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>"Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 

public long transRead(long timeOut) 

{ 

return readIfExists2(timeOut, this.getTransactionHandler()); 

} 

/** Takes an entry value with transaction; entry will be removed from space 

* ©param timeOut the maximum waiting time when reading the entry 

* ©param this. transaction must be a valid transaction handle 

* ©return <tt>"Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 

public long transTake( long timeOut) 

{ 

return takelfExists2(timeOut, this.getTransactionHandler()); 

} 
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9. TSHash.java 

package tuplespace.core; 

import tuplespace.entries.*; 

import java.util.HashMap; 

import netoini.space.JavaSpace; 

import net.jini.core.entry.Entry; 

import net.jini.core.lease.Lease; 

import net.jini.core.transaction.*; 

import net.jini.core.event.EventRegistration; 


/★ * 

* The <code>TSHash</code> class implements the methods for reading, writing, 

* updating, notifying eind retrieving EntryHash entry from space. Every 

* EntryHash entry in the space is identified by an unique ID (entrylD). 

* A subclass that implements the Space Ac tionHandler interface has to loaded 

* during initialization if remote event notification is used. 

* 

* @author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 

* ©see EntryHash 
*/ 


public class TSHash extends TSBase implements java.io.Serializable, 
SpaceEventRegistration, TSConstants{ 
private EntryHash entry, entryTemplate; 
private HashMap container; 

/** Constructor for TSHash 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed(ActionEveht 

* method, called when remote event is rised. 

* ©param entrylD the unique ID that identifies the Hash Entry 
*/ 

public TSHash(JavaSpace space. SpaceActionHandler spaceAction, String entrylD) { 
super(); 

initTSHash{space, spaceAction, entrylD); 

} 

/** initialize TSHash 
*■ ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent 

* method; called when remote event is raised. 

* ©param entrylD the unique ID that identifies the Hash Entry 

* ©return <tt>true</tt> if internal states are sucessfully reinitialized. 

*/ 

public boolean initTSHash(JavaSpace space, SpaceActionHandler spaceAction, 
entrylD) 

{ 

try{ 

initTSBase(space, spaceAction, entrylD); 
container = new HashMap(); 
entry = new EntryHash(entrylD); 
entiryTemplate = new EntryHash(entrylD); 
eventRegistration = null; 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

/** Remove all existing entries from space */ 
public void cleanSpace() 

{ 

cleanSpacel(null); 

} 

/** Remove all existing entries from space 


e) 


String 
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* @parain txn a valid transaction handle */ 
public void cleanSpacel(Transaction txn) 

{ 

Object test; 
do{ 

try{ 

test = space.takeIfExists(entryTeinplate,txn,1000); 
//print ("remove [" + entrylD + "] from space"); 
}catch (Exception e){ 
e.printStackTrace() ; 
test = null; 

} 

}while(test != null); 

} 


//********************★***************************** 

//*** HashMap Operation *** 

//************************************************** 
public boolean clearContainer(){ 
container = new HashMap(); 
return true; 


public HashMap getContainer(){ 
return container ; 

} 

public void getContainer(HashMap map){ 
container = map; 

} 

public boolean setBoolean(String id, boolean value){ 
try{ 

container .put (id, new Boolean (value) ) ; 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

public boolean setinteger(String id, int value){ 
try{ 

container.put(id,new Integer(value)); 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

public boolean setFloat(String id, float value){ 
try{ 

container.put(id,new Float(value)) ; 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

public boolean setLong(String id, long value){ 
try{ 

container.put(id,new Long(value)); 
return true; 

} 

catch(Exception e){ 
return false; 

} 
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public boolean setDouble(String id, double value){ 
t 2 ry{ 

container.put(id,new Double(value)); 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

public boolean setstring(String id, String content){ 
try{ 

container.put(id,content); 
return true; 

} 

catch(Exception e){ 
return false; 

> 

} 

public boolean remove(String id){ 
if(container.containsKey{id)){ 
container.remove(id); 
return true; 

} 

else{ 

return false; 

} 

} 

public int getinteger(String id){ 

Integer item; 
try{ 

item = (Integer) container.get(id); 
return item.intValue(); 

} catch (Exception e) { 

System.err.printIn(e.getMessage()); 
return -1; 

} 

} 

public boolean getBoolean(String id){ 

Boolean item; 
try{ 

item = (Boolean) container.get(id); 
return item-booleanValue(); 

} catch (Exception e) { 

System.err.println(e.getMessage()); 
return false; 

} 

} 


public float getFloat(String id){ 

Float item; 
try{ 

item = (Float) container.get(id); 
return item.floatvalue(); 

} catch (Exception e) { 

System.err.println(e.getMessage()); 
return -1; 

} 

} 

public long getLong(String id){ 

Long item; 
try{ 

item = (Long) container.get(id); 
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return item.longValue(); 

} catch (Exception e) { 

Systern.err.println{e.getMessage()); 
return -1; 

} 

} 

public double getDouble(String id){ 

Double item; 
try{ 

item = (Double) container.get(id); 
return item.doubleValue(); 

} catch (Exception e) { 

System.err.printIn(e.getMessage 0); 
return -1; 

} 

} 

public String getString(String id){ 

String item; 
try{ 

item = (String) container.get(id); 
return item; 

} catch (Exception e) { 

Systern.err.printIn(e.getMessage()); 

return "Error finding ID["+id+"] in Hash Map"; 

} 

} 


//**★*******★**★********★*★**********•**★************★************* 
//*** Write Entry 

* * * 

//*********************•★*★**★**********★******★****★*******★****•** 
/** Writes value to space 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean write() 

{ 

return write2( this.writeLeaseTime, null); 

} 

/** Writes value to space 

* ©param lease the amount of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writel( long lease) 

{ 

return write2( lease, null); 

} 

/** Writes value to space 

* ©param lease the amotint of time entry is placed in space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if ent 2 ry is sucessfully written to space. */ 
public boolean write2{ long lease. Transaction txn) 

{ 

try{ 

entry = new EntryHash(this.entrylD, container); 
space.write(entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 
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//*** Update Entry 

* * * 

y/**************************************************************** 

/** Updates an existing entry value 

* @parain value the entry value (Hash) to be updated 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean update() 

{ 

return update2{ this.updateLeaseTime, null); 

} 

/** Updates an existing entry value 

* ©param value the double value that is to be updated 

* ©param lease the amount of time entry is placed in space 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean update1( long lease) 

{ 

return update2( lease, null); 

} 

/** Updates an existing entry value 

* ©param lease the amount of time entry is placed in space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean update2( long lease, Transaction txn) 

{ 

try{ 

cleanSpacel(txn); 

entry = new EntryHash(this.entrylD, container); 
space.write(entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 


******^***********iir**** ********* ******************** *********** 

//*** Read Entry 

* * * 

yr/*******^*****^*****^******** **************************** ******** 

/** Read entry value 

* ©return <tt>-l</tt> if entry is not available, otherwise 

* the entry value. */ 
public boolean readIfExists() 

{ 

return readIfExists2(this.readTimeOut, null); 

} 

/** Read entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean readlfExistsl(long timeOut) 

{ 

return readIfExists2(timeOut, null); 

} 

/** Read entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. 

public boolean readIfExists2(long timeOut, Transaction txn) 

{ 
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this.setResult(false); 
try{ 

entry = (EntryHash) space.readlfExists(entryTemplate/ txn, timeOut); 
if( entry != null) 

{ 

this.setResult(true); 
container = entry.getHashMap(); 
return true; 

} 

else 

return false; 

} 

catch (Exception e){ 

e.printstackTrace(); 
return false; 

} 


//****★******★**★************★*★*•**********************★**★*★*★*** 

//*** Take Entry 

* * * 

//***★★****★***★*****************************************★★*★***** 

/** Take entry value; entry will be removed from space 

* @retum <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 
public boolean takelfExists() 

{ 

return takelfExistsl(this.takeTimeOut); 

} 

/** Take entry value; entry will be removed from space 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean takelfExistsl( long timeOut) 

{ 

return takeIfExists2(timeOut, null); 

} 

/** Take entry value; entry will be removed from space 

* ©param timeOut the maximum waiting time when reading the entry 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>false</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean takeIfExists2( long timeOut, Transaction txn) 

{ 

this.setResult(false); 
try{ 

entry = (EntryHash) space.takelfExists(entryTenplate, txn, timeOut) 
if( entry != null) 

{ 

this.setResult(true); 
container = entry.getHashMap(); 
return true; 

} 

else 

return false; 

} 

catch (Exception e){ 
e.printStackTrace() 

return false; 

} 

} 


//*** Notify 



/** start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventO 

{ 

return startEventB(this.spaceAction, this.notifyLeaseTime/ null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventl(SpaceActionHandler spaceAction) 

{ 

return startEventB(spaceAction, this.notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed (ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amount of time for notification to remain active 

* ©return <tt>true</tt> if notification is enabled. '*'! 

public boolean startEvent2(SpaceActionHandler spaceAction, long lease ) 

{ 

return startEventB(spaceAction, lease , null); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amount of time for notification to remain active 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEventB(SpaceActionHandler spaceAction, long lease , Transaction 
txn) 

{ 

try{ 

// Remove earlier event notification 
if(eventRegistration != null) 

eventRegistration.getLease().cancel(); 

// Register new event notification 

SpaceEventListener listener = new SpaceEventListener(TS_HASH, entrylD, 

space,SpaceAction); 

eventRegi St rat ion = space. notify(entryTeirplate, txn, listener, lease, null); 
return true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

> 

} 

/** Stop notification 

* ©return <tt>true</tt> if notification is disabled. */ 
public boolean stopEvent(){ 

try{ 

if( eventRegistration != null) 

{ 

eventRegistration.getLease().cancel(); 
eventRegistration = null; 

) 

return true; 

} 

catch (Exception e){ 
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return false; 



//*** Transaction Methods 
* * * 


/** Writes entry value with transaction 

* @parain value the float value that is to be written to space 

* @parain lease the amount of time entry is placed in space 

* @param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transWriteC long lease) 

{ 

return write2{lease,this.getTransactionHandler()); 

} 

/** Updates an existing entry value with transaction 

* ©param value the float value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transUpdateC long lease) 

{ 

return update2(lease,this.getTransactionHandler()); 

} 

/** Reads an entry value with transaction 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>'’Exception in method !''</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolean transRead(long timeOut) 

{ 

this.setResult(false); 
try{ 

entry = (EntryHash) space, readi f Exi st s (entryTemplate, 

this. getTransactionHandler (), timeOut) 
if( entry »= null) 

{ 

this.setResult(true); 
container = entry.getHashMap() ; 
return true; 

} 

else 

return false; 

} 

catch (Exception e){ 

e-printStackTrace() ; 
return false; 

} 

} 

/** Takes an entry value with transaction; entry will be removed from space 

* ©param timeOut the maximum waiting time when reading the entry 

* ©param this. transaction must be a valid transaction handle 

* ©return <tt>"Exception in method !''</tt> if entry is not available, otherwise 

* the entry value. */ 

public boolecin transTake( long timeOut) 

{ 

this.setResult(false); 
try{ 

entry = (EntryHash) space, takelfExists (entryTeirplate, 

this.getTransactionHandler(), timeOut); 
if( entry != null) 

{ 


this. setResult (true) ,* 
container = entry.getHashMap() ,* 
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return true; 


} 

else 

return false; 

} 

catch {Exception e){ 
e.printStackTrace(); 

return false; 

} 

> 

} 
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10. TSQueue.java 

package tuplespace.core; 

import tuplespace.entries.*; 

import net.jini.space.JavaSpace; 

import net.jini.core.entry.Entry 7 

import net.jini.core.lease.Lease; 

import net.jini.core.transaction.*; 

import net.jini.core.event.EventRegistration; 

I -kit 

* The <code>TSQueue</code> class implements the methods for reading, writing, 

* updating, notifying and retrieving EntryQueue entry from space. Every 

* EntryQueue entry in the space is identified by an unique ID (entrylD). 

* A subclass that implements the SpaceActionHandler interface has to loaded 

* during initialization if remote event notification is used. 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 

* ©see EntryQueue 
*/ 

public class TSQueue extends TSBase irrplements java.io.Serializable, 
SpaceEventRegistration, TSConstants{ 
private EntryQueueltem item, itemTerrplate; 
private EntryQueueStatus status, statusTeirplate,- 
private long bufferSize; 

/** Constructor for TSQueue 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed{ActionEvent e) 

* method, called when remote event is rised. 

* ©param entrylD the unique ID that identifies the Queue Entry 
*/ 

public TSQueue(JavaSpace space, SpaceActionHandler spaceAction, String entrylD, long 
size) { 

super(); 

initTSQueue(space, spaceAction, entrylD, size); 

} 

/** initialize TSQueue 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed{ActionEvent e) 

* method; called when remote event is raised. 

* ©param entrylD the unique ID that identifies the Queue Entry 

* ©return <tt>true</tt> if internal states are sucessfully reinitialized. 

*/ 

public boolean initTSQueue(JavaSpace space, SpaceActionHandler spaceAction, String 
entrylD, long size) 

{ 

this.bufferSize = size; 
try{ 

initTSBase(space, spaceAction, entrylD); 
item = new EntryQueueltem (entrylD) ; 
itemTemplate = new EntryQueueltem (entrylD) ; 

status = new EntryQueueStatus(entrylD,size); 
statusTeirplate = new EntryQueueStatus (entrylD) ; 
initQueueIndexes() ; 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 

/** Initialize */ 

private boolean initQueueIndexes() 
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{ 

try{ 

status = (EntryQuGueStatus) space.read(statusTemplate,null,2000) 
if(status == null ){ 
cleanSpace{); 

status = new EntryQueueStatus(entryID,bufferSize); 
space.write(status,null, Lease.FOREVER); 
print("Initialized! TSQueue"); 
return true; 

} 

else 

retuin false; 

}catch (Exception e){ 

e.printStackTrace() ; 
return false; 

} 

> 

/** Remove all existing entries from space */ 
public void cleanSpace() 

{ 

cleanSpacel(null); 

} 

/** Remove all existing entries from space 

* @param txn a valid transaction handle */ 
public void cleanSpacel(Transaction txn) 

{ 

Object test; 
do{ 

try{ 

test = space.takelfExists(statusTemplate,txn,2000); 
print("removing stack Start Index from space"); 

}catch (Exception e){ 
e.printStackTrace(); 
test = null; 

} 

}while(test != null); 
do{ 

try{ 

test = space.takeIfExists(itemTernplate,txn,2000); 
print (" removing stack item from space"); 

>catch (Exception e){ 
e.printStackTrace(); 
test = null; 

} 

}while(test != null); 

} 

/** Remove all existing entries from space */ 
public void cleanItem(long index) 

{ 

cleanlteml (null, index); 

} 

/** Remove all existing entries from space 

* (sparam txn a valid transaction handle */ 
public void cleanlteml(Transaction txn, long index) 

{ 

Object test; 
do{ 

try{ 

EntryQueueltem itemTmp = new EntryQueueltem(entrylD); 

itemTmp.position = new Long(index); 

test = space.takeIfExists(itemTmp,txn,1000); 

print("removing stack item from space"); 

}catch (Exception e){ 
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e-printStackTrace{); 
test = null; 

} 

}while(test != null); 

} 


/** Remove all existing entries from space */ 
public void cleanStatus() 

{ 

cleanStatusl(null); 

} 

/** Remove all existing entries from space 
* @param txn a valid transaction handle */ 
public void cleanStatusl(Transaction txn) 

{ 

Object test; 
do{ 

try{ 

EntryQueueStatus itemTmp = new EntryQueueStatus (entrylD) ; 
test = space.takelfExists(itemTmp,txn,1000); 
print("removing stack item from space”); 

}catch (Exception e) { 
e-printStackTrace(); 
test = null; 

} 

}while(test != null); 

) 


public String readldong index) { 
try{ 

itemTeirplate-position = new Long(index) ; 

item = (EntryQueueltem) space.readlfExists(itemTemplate,null,2000) ; 
if(item != null){ 

print ("Queue item[" + index + ”] -> " + item, content) ; 
return item.content; 

} 

else 

return null; 

} catch(Exception e){ 
e.printStackTrace(); 
return null; 

} 

} 

/** Updates an existing entry value 

* @param value the String value that is to be updated 

* @param lease the amount of time entry is placed in space 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 

private boolean updates (String msg, long lease, Transaction txn, long index) 
{ 

try{ 

cleanlteml(txn, index); 

item = new EntryQueueItem(entryID,index,msg); 
space.write(item, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace() ; 
return false; 

} 

} 

public String take{){ 
return takel(null); 

} 


public String takel( Transaction txn){ 
long startindex; 
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try{ 

status = (EntDryQueueStatus) space.readlfExists (statusTemplate, txn, 2000) ; 
if{status 1= null){ 

if (! status. isEmptyO ) { 
startindex = status.startIndex.longValueO; 
itemTeinplate.position = new Long(startindex) ; 

item = (EntryQueueltem) space. takelfExists (itemTeinplate, txn, 2000) ; 
status. increment Start Index {) ; 
cleanStatusl(txn); 

space.write(status,txn. Lease.FOREVER); 

print("Queue item[" + startindex + ”3 -> " + item.content); 
return item.content; 

} 


} 

return null; 

}catch(Exception e){ 
e.printstackTrace(); 
retuim null; 

} 

} 

public boolean writel (String msg) { 
return write2(msg,null); 

} 

public boolean write2(String msg. Transaction txn){ 
long nextIndex; 
try{ 

status = (EntryQueueStatus) space.readlfExists(statusTemplate,txn,2000); 
if(status != null ){ 

if( !status.isFull()){ 

status.incrementEndIndex(); 

nextIndex = status.endindex.longValue(); 

print ("Written! " + msg + " to space" + " Index->'’ + nextindex) ; 
updates(msg. Lease.FOREVER, txn,nextindex); 
cleanStatusl(txn); 

space-write(status,txn, Lease.FOREVER); 
return true; 

} 

} 

return false; 

} catch (Exception e){ 
e - prints taclcTrace () ; 
return false; 

} 

} 

public void printQueue{){ 
trY{ 

status = (EntryQueueStatus) space.read{statusTemplate,null,2000); 
print ("Start Index : " + status.getstartindex() + " End Index 

status.getEndindex()); 

for(long i = status.getStartIndex(); i <= status.getEndIndex{);i++) 

{ 

itemTemp late, posit ion = new Long(i) ,- 

item = (EntryQueueltem) space.readlfExists(itemTemplate,null,2000); 
if(item != null) 

printC'Queue item[" + i + "] -> " + item.content); 

} 

} catch (Exception e){ 
e.printStackTrace{); 

} 

} 
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//*** Notify 


* * * 




/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventO 

{ 

return startEvent3(this.spaceAction, this.notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventl(SpaceActionHandler spaceAction) 

{ 

return startEvent3{spaceAction, this.notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amount of time for notification to remain active 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEvent2(SpaceActionHandler spaceAction, long lease ) 

return startEventB(spaceAction, lease , null); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerf ormed (ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amount of time for notification to remain active 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEventB(SpaceActionHandler spaceAction, long lease , Transaction 
txn) 

{ 

try{ 

// Remove earlier event notification 
if(eventRegistration != null) 

eventRegistration.getLease().cancel(); 

// Register new event notification 
itemTemplate = new EntryQueueltem(entrylD); 

SpaceEventListener listener = new SpaceEventListener(TS_QUEUE, entrylD, 
space,spaceAction); 

eventRegistration = space.notify(itemTemplate, txn, listener, lease, null); 
retum true; 

} 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

} 

/** Stop notification 

* ©return <tt>t 2 rue</tt> if notification is disabled. */ 
public boolean stopEvent(){ 

try{ 

if{ eventRegistration != null) 

{ 


eventRegistration.getLease{).cancel (); 
eventRegistration = null; 
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} 

return true; 

} 

catch (Exception e){ 
return false; 

} 

} 

public long getStartIndex(){ 
try{ 

status = (EntryQueueStatus) space.readIfExists(statusTemplate,null,2000) 
return status.getStartIndex(); 

} catch(Exception e){ 
return -1; 

} 

} 

public long getEndIndex(){ 
try{ 

status = (EntryQueueStatus) space.readlfExists(statusTerrplate,null,2000) 
return status.getEndIndex{); 

} catch(Exception e){ 
return -1; 

} 

} 

} 
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11. TSString.java 

package tuplespace.core; 

iirport tuplespace.entries. *; 

irrport net.jini.space.JavaSpace; 

import net.jini.core.entry.Entry; 

import net.jini.core.lease.Lease; 

import net.jini.core,transaction.*; 

irrport net. j ini . core. event. EventRegistration; 

j -k* 

* The <code>TSString</code> class implements the methods for reading, writing, 

* updating, notifying and retrieving Entrystring entry from space. Every 

* Entrystring entry in the space is identified by an unique ID (entrylD). 

* 

* A subclass that implements the SpaceActionHandler interface has to loaded 

* during initialization if remote event notification is used. 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 October 2000 

* ©see Entrystring 
*/ 


public class TSString extends TSBase implements java.io.Serializable, 
SpaceEventRegistration, TSConstants{ 
private Entrystring entry, entryTeirplate; 


/ * k 


k 


*/ 


Constructor for TSString 
©param space JavaSpace handle 

©param spaceAction the class that implements the actionPerformed(ActionEvent 
method, called when remote event is rised. 

©param entrylD the unique ID that identifies the String Entry 


e) 


public TSString(JavaSpace space, SpaceActionHandler spaceAction, String entrylD) { 
super(); 

initTSString(space, spaceAction, entrylD); 

} 


/** initialize TSString 

* ©param space JavaSpace handle 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param entrylD the unique ID that identifies the String Entry 

* ©return <tt>true</tt> if internal states are sucessfully reinitialized. 

*/ 

public boolean initTSString(JavaSpace space, SpaceActionHandler spaceAction, String 
entrylD) 

{ 

try{ 

initTSBase(space, spaceAction, entrylD); 
entry = new Entrystring(entrylD); 
entryTemplate = new Entrystring(entrylD); 
return true; 

} 

catch(Exception e){ 
return false; 

} 

} 


/** Remove all existing entries from space */ 
public void cleanSpaceO 
{ 

cleanSpacel(null); 

} 

/** Remove all existing entries from space 
* ©param txn a valid transaction handle */ 
public void cleanSpacel(Transaction txn) 

{ 
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Object test; 
do{ 

try{ 

test = space.takeIfExists(ent2:yreiTvplat€,txn/1000); 

//print ("remove [*' + entrylD + "] from space"); 

}catch (Exception e){ 
e-printstackTrace(); 
test = null; 

} 

}while{test != null); 

} 

//***★****★******★***************************★*******★************ 
//*** Write Entry 

* ★ * 

//***********★**★****★*************************************★****** 

/** Writes value to space 

* @param value the entry value (String) 

* @return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writel(String value) 

{ 

return writes( value, this.writeLeaseTime, null); 

} 

/** Writes value to space 

* @param value the String value that is to be written to space 

* @param lease the amount of time entry is placed in space 

* @retum <tt>true</tt> if entry is sucessfully written to space. */ 
pxiblic boolean write2 (String value, long lease) 

{ 

return writes( value, lease, null); 

} 

/** Writes value to space 

* @param value the String value that is to be written to space 

* @param lease the amount of time entry is placed in space 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean writeS(String value, long lease, Transaction txn) 

{ 

try{ 

entry = new Entrystring (this, entry ID, value); 
space, write (entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printstackTrace() ; 
return false; 

> 

} 


//★**★******★****★*★***★*★**********★***★**★*★*★★**★****★***★***** 
//*** Update Entry 

* * ★ 

y/★********★★*****************★*****★*******★*********★*********** 

/** Updates an existing entry value 

* ©param value the entry value (String) to be updated 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean updatel(String value) 

{ 

return updates( value, this.updateLeaseTime, null); 

> 

/** Updates an existing entry value 

* ©param value the String value that is to be updated 

* ©param lease the amount of time entry is placed in space 
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* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean update2(String value, long lease) 

{ 

return updates{ value, lease, null); 

} 

/** Updates an existing entry value 

* ©param value the String value that is to be updated 

* ©param lease the amount of time entry is placed in space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if entry is sucessfully updated. */ 
public boolean updates(String value, long lease. Transaction txn) 

{ 

try{ 

cleanSpacel(txn); 

entry = new Entrystring(this.entrylD, value); 
space.write(entry, txn, lease); 

return true; 

} 

catch (Exception e){ 

e.printStackTrace{); 
return false; 

} 

} 


/firt,* Read Entry 

* ★ * 

//********-k*******-k****it*-k*****ir**ic-k**itir****ici,1f**ir*-k****iri,*-k***i,ir-k 

/** Reads an entry value 

* ©return <tt>”Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 

public String readIfExists() 

{ 

return readIfExists2(this.readTimeOut, null); 

} 

/** Reads an entry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©return <tt>"Exception in method !''</tt> if entry is not available, otherwise 

* the entry value. */ 

public String readlfExistsl(long timeOut) 

{ 

return readIfExists2(timeOut, null); 

} 

/** Reads an ent 2 ry value 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>"Exception in method !''</tt> if entry is not available, otherwise 

* the entry value. */ 

public String readIfExists2(long timeOut, Transaction txn) 

{ 

this.setResuit(false); 
try{ 

entry = (Entrystring) space. readIfExists (entryTeirplate, txn, timeOut); 
if( entry i= null) 

{ 

this.setResult(true); 

return entry. entrystring ; 

} 

else 

return "No Entry Found!"; 

} 

catch (Exception e){ 

e.printStackTrace{); 

return "Exception in method !"; 


228 


} 


} 


//****************ir**ir****-k*icic*itir****-*i,**-kir*-kir-k*ifk-k**ick-k*****ir*ic-i(* 

//*** Take Entry 

* * * 

//*********ir*******i,***************:kic***-/,*ir*****ic*-kicic-k*ir**ic****icic* 

/** Takes an entry value; entry will be removed from space 

* eretum <Ct>"Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 
public String takelfExists(} 

{ 

return takelfExistsl(this.takeTimeOut); 

} 

/** Takes an entiry value; entry will be removed from space 

* @retum <tt>’’Exception in method !’'</tt> if entry is not available, otherwise 

* the entry value. */ 

public String takelfExistsl( long timeOut) 

{ 

return takeIfExists2{timeOut, null); 

} 

/** Takes an entry value; entry will be removed from space 

* @param timeOut the maximum waiting time when reading the entiry 

* @param txn a valid transaction handle, if transaction is involved 

* ©return <tt>"Exception in method «"</tt> if entry is not available, otherwise 

* the entry value. */ 

public String takeIfExists2( long timeOut, Transaction txn) 

{ 

this.setResuit(false); 
try{ 

entry = (Entrystring) space.takelfExists(entryTemplate, txn, timeOut) 
if( entry != null) 

{ 

this.setResult(true); 

return entry.entrystring; 

} 

else 

return "No Entry Found!",- 

} 

catch (Exception e){ 
e.printStackTrace(); 

return "Exception in method 

} 

} 


//***********ir-k*****i,**iric*-kic****i,**-k*ir*i,**ic*i,i,iHt****iric-k*-k*ic-k*irir-k** 

//*** Notify 

* ★ * 

//********-k**ir*-k-kir*ic****i,-k********-k*-k**-k*ir*icic***ic*-kieiri,i,1tir***-k*iric** 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEvent{) 

{ 

return startEventS (this.spaceAction, this.notifyLeaseTime, null ) ,- 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed (ActionEvent e) 

* method; called when remote event is raised. 
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* ©return <tt>true</tt> if notification is enabled. */ 
public boolean startEventl(SpaceActionHandler spaceAction) 

{ 

return startEventS(spaceAction, this.notifyLeaseTime, null ); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amo-unt of time for notification to remain active 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEvent2(SpaceActionHandler spaceAction, long lease ) 

{ 

return startEventS(spaceAction, lease , null); 

} 

/** Start notificiation; remote event will be raised if any entry 

* that matches the entry ID is added into the space. 

* ©param spaceAction the class that implements the actionPerformed(ActionEvent e) 

* method; called when remote event is raised. 

* ©param lease the amomt of time for notification to remain active 

* ©param txn a valid transaction handle, if transaction is involved 

* ©return <tt>true</tt> if notification is enabled. */ 

public boolean startEvent3(SpaceActionHandler spaceAction, long lease , Transaction 
txn) 

{ 

try{ 

// Remove earlier event notification 
if(eventRegistration '= null){ 
try { 

Lease 1 = eventRegistration.getLease(); 

1.cancel(); 

}catch (Exception e){} 

} 

// Register new event notification 

SpaceEventListener listener = new SpaceEventListener(TS_STRING, entrylD, 
space,SpaceAction); 

eventRegistration = space.notify(entryTemplate, txn, listener, lease, null); 
return true; 

> 

catch (Exception e){ 

e.printStackTrace(); 
return false; 

} 

> 

/** Stop notification 

* ©return <tt>true</tt> if notification is disabled. */ 
public boolean stopEvent(){ 

try{ 

if( eventRegistration != null) 

{ 

try { 

Lease 1 = eventRegistration.getLease(); 

1.cancel(); 

}catch (Exception e){} ♦ 

eventRegistration = null; 

} 

return true; 

} 

catch (Exception e){ 
return false; 

} 

} 

//******************★***************★*********★****************★** 

//*** Transaction Methods 
* * ★ 
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//***★*****************★★***************************************** 

/** Writes entzy value with transaction 

* @pararr\ value the String value that is to be written to space 

* @param lease the amount of time entry is placed in space 

* @param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if entry is sucessfully written to space. */ 
public boolean transWrite{String value, long lease) 

{ 

retuim writeB(value,lease,this.getTransactionHandler()); 

} 

/** Updates an existing entry value with transaction 

* ©param value the String value that is to be written to space 

* ©param lease the amount of time entry is placed in space 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>true</tt> if ent 2 ry is sucessfully written to space. */ 
public boolean transUpdate(String value, long lease) 

{ 

return updates (value, lease,this.getTransactionHandler{)); 

} 

/** Reads an entry value with transaction 

* ©param timeOut the maximum waiting time when reading the entry from space 

* ©param this - transaction must be a valid transaction handle 

* ©return <tt>”Exception in method !"</tt> if entry is not available, otherwise 

* the entry value. */ 

public String transReaddong timeOut) 

{ 

return readIfExists2(timeOut, this.getTransactionHandler()); 

} 

/** Takes an entry value with transaction; entry will be removed from space 

* ©param timeOut the maximima waiting time when reading the entry 

* ©param this.transaction must be a valid transaction handle 

* ©return <tt>"Exception in method !’'</tt> if entry is not available, otherwise 

* the entry value. */ 

public String transTake( long timeOut) 

{ 

return takeIfExists2(timeOut, this.getTransactionHandler()); 

> 

} 
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C. ENTRIES PACKAGE 

1. EntryBoolean.java 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 

/** 

* The <code>EntryBoolean</code> is the entry template for type - Boolean 

* 

* @author Kin Boon Kwang 

* ©version 1.0/ 01 Oct. 2000 
*/ 

public class EntryBoolean implements Entry { 
public String entrylD; 
public Boolean entryBoolean; 

public EntryBoolean{){ 

} 

p-oblic EntryBoolean (String entrylD) { 
this.entrylD = entrylD; 

} 

public EntryBoolean(String entrylD, boolean entryValue){ 
this.entrylD = entrylD; 

this.entryBoolean = new Boolean(entryValue); 

} 

} 


2. EntryBytes.java 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 


/ * * 

* The <code>EntryBytes</code> is the entry tenplate for type - Bytes 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryBytes implements Entry { 
public String entrylD; 
public Byte(] entryBytes; 

public EntryBytes(){ 

} 

public EntryBytes(String entrylD){ 
this.entrylD = entrylD; 

} 

public EntryBytes(String entrylD,Byte[] entryValue){ 
this.entrylD = entrylD; 
this.entryBytes = entryValue; 

} 

} 


232 




3. EntryClass.java 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 


j-k-k 

* The <code>EntryClass</code> is the entry template for type - Class 
*• 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryClass implements Entry { 
public String entrylD; 
public String codeURL; 
public String className; 

public EntryClass(){ 

} 

public EntryClass(String entrylD){ 
this.entrylD = entrylD; 

} 

public EntryClass(String entrylD, String codeURL, String className){ 
this.entrylD = entrylD; 
this.codeURL = codeURL; 
this. className = className; 

} 

} 

4. EntryDouble.java 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 

/★* 

* The <code>EntryDouble</code> is the entry teirplate for type - Double 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryDouble implements Entry { 
public String entrylD; 
public Do\ible entryDouble; 

public EntryDouble () { 

} 

public EntryDouble(String entrylD){ 
this.entrylD = entrylD; 

} 

public EntryDouble(String entrylD, double entryValue){ 
this.entrylD = entrylD; 

this.entryDouble = new Double(entryValue); 

} 

} 

5. EntryFloatjava 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 

I k k 

* The <code>EntryFloat</code> is the entry template for type - Float 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
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/ 


public class EntryFloat iirplements Entry { 
public String entrylD; 
public Float entryFloat; 

public EntryFloat0{ 

} 

public EntryFloat(String entrylD){ 
this-entiylD = entrylD; 

} 

public EntryFloat(String entrylD, float entryValue){ 
this.entrylD = entrylD; 
this.entryFloat = new Float(entryValue); 

} 

} 

6. EntryHash.java 

package tuplespace.entries; 
iinport net.jini.core.entry.Entry; 
import j ava.util.HashMap; 

/ ** 

* The <code>EntryHash</code> is the entry template for type - User Defined 

★ 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryHash implements Entry { 
public HashMap map; 
public String entrylD; 
ptiblic Integer entryinteger; 

public EntryHash(){ 

} 

public EntryHash(String entrylD){ 
this.entrylD = entrylD; 

} 

public EntryHash(String entrylD, HashMap map){ 
this.entrylD = entrylD; 
this, map = map; 

} 

public HashMap getHashMap(){ 
return map; 

} 

public void setHashMap(HashMap map){ 
this.map = map; 

} 

} 

7. Entryinteger.java 

package tuplespace.entries; 
import net. j ini .core, entry. Entry; 


f** 

* The <code>EntryInteger</code> is the entry template for type - Integer 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
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*/ 

public class Entryinteger implements Entry { 
public String entryID; 
public Integer entjryinteger; 

public Entryinteger(){ 

} 

public Entryinteger(String entrylD){ 
this.entryID = entrylD; 

} 

public Entryinteger(String entrylD, int entryValue){ 
this.entryID = entrylD; 

this.entryInteger = new Integer(entryValue); 

} 

} 

8. EntryLong.java 

package tuplespace.entries; 
import net.jini.core.entry-Entry; 

/ * * 

* The <code>EntryLong</code> is the entry terrplate for type - Long 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryLong implements Entry { 
public String entrylD; 
public Long entryLong; 

public EntryLong(){ 

} 

public EntryLong(String entrylD){ 
this.entrylD = entrylD; 

> 

public EntryLong(String entrylD, long entryValue){ 
this.entrylD = entrylD; 
this. entryLong = new Long (entryValue) ; 

} 

} 


9. EntryListltem-java 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 

j ** 

* The <code>EntryListItem</code> is the entry template for List item 

■k 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryListItem implements Entry { 
public String entrylD; 
public Long position; 
public String content; 

public EntryListItem(){ 

} 

public EntryListItem(String entrylD){ 
this.entrylD = entrylD; 

} 
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public EntryListltemtString entrylD, long position. String msg){ 
this.entrylD = entrylD; 
this-position = new Long(position); 
this.content = msg; 

} 

public EntryListItem(String entrylD, long position){ 
this.entrylD = entrylD; 
this.position = new Long(position); 

} 

} 


10 EntryListStatus.java 

package tuplespace.entries; 

import net.jini.core.entry.Entry; 

/** 

* The <code>EntryListStatus</cod€> is the entry template for List status 

★ 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 

*/ 

public class EntryListStatus implements Entry { 
public String entrylD; 
public Long startIndex; 
public Long endindex; 
public Long maxSize; 

public EntryListStatus(){ 

} 

public EntryListStatus(String entrylD){ 
this.entrylD = entrylD; 

} 

public EntryListStatus(String entrylD, long maxSize){ 
this.entrylD = entrylD; 
this.maxSize = new Long (maxSize) ; 
this.startindex = new Long(O); 
this.endindex = new Long{); 

} 

public long getCurSize(){ 

return (endindex. longValue () - startindex. longValue () +1) ; 

} 

public long getMaxSize(){ 
return maxSize. longValue () ; 

} 

public long getStartIndex(){ 

return startindex.longValue (); 

} 

public long getEndIndex(){ 

return endindex.longValue (); 

} 


public boolean isErnpty(){ 

if(startindex.longValue() > endindex.longValue()) 
return true; 
else 

return false; 

} 
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public boolean isFull(){ 

if(maxSize.intValueO <= (endindex.longValue() - startIndex.longValue{))) 
return true; 
else 

return false; 

} 

public boolean incrementstartlndex{){ 

if(startindex.longValue() <= endindex.longValue()){ 
startIndex = new Long(startindex.intValue{)+1); 
return true; 

}else 

return false; 

} 

public boolean incrementEndindex0{ 

if(maxSize.longValue{) > (endindex,longValue() - startindex.longValue())){ 
endindex = new Long(endindex.intValue()+1); 
return true; 

}else 

return false; 

} 

} 


11 Entry Queueltein.java 

package tuplespace.entries; 
iirport net-jini .core.entry.Entry; 

/** 

* The <code>EntryQueueItem</code> is the entry template for Queue item 

* 

* ^author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryQueueltem irtplements Entry { 
public String entrylD; 
public Long position; 
public String content; 

public EntryQueueItem(){ 

} 

public EntryQueueltem(String entrylD){ 
this.entrylD = entrylD; 

} 


public EntryQueueltem(String entrylD, long position. String msg){ 
this.entrylD = entrylD; 
this.position = new Long(position); 
this.content = msg; 

} 

public EntryQueueltem(String entrylD, long position){ 
this.entrylD = entrylD; 
this.position = new Long(position); 

} 

) 

12 EntryQueueStatusjava 

package tuplespace.entries; 

iirport net-j ini .core, entry. Entry; 

/** 

* The <code>EntryQueueStatus</code> is the entry template for Queue status 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
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*/ 


public class EntryQueueStatus implements Entry { 
public String entrylD; 
public Long startindex; 
public Long endindex; 
public Long maxSize; 

public EntryQueueStatus(){ 

} 

public EntryQueueStatus(String entrylD){ 
this.entrylD = entrylD; 

} 

public EntryQueueStatus(String entrylD, long maxSize){ 
this.entrylD = entrylD; 
this.maxSize = new Long(maxSize); 
this.startindex = new Long(O); 
this.endindex = new Long(-1); 

} 

public long getCurSize{){ 

return (endindex.longValue() - startindex.longValue() +1); 

} 

public long getMaxSize{){ 
return maxSize.longValue(); 

} 

public long getStartIndex(){ 

return startindex.longValue (); 

} 

public long getEndindex(){ 

return endindex.longValue (); 

} 


public boolean isEmpty(){ 

if(startindex.longValue() > endindex.longValue()) 
return true; 
else 

return false; 


public boolean isFull(){ 

if (maxSize.intValueO <= (endindex.longValue() - startindex.longValue ())) 
return tmae; 
else 

return falser- 


public boolean incrementstartlndex(){ 

if(startindex.longValue() <= endindex.longValue()){ 
startindex = new Long(startindex.intValue()+1); 
return true; 

}else 

return false; 


public boolean incrementEndindex(){ 

if (maxSize.longValue0 > (endindex.1ongVa1ue() - startindex.longValue())){ 
endindex = new Long {endindex. intValue () +1) ; 
return true; 

}else 

return false; 

} 

} 
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12 EntryStackItem.java 

package tuplespace.entries; 
irrport net.jini.core.entry.Entry; 

/** 

* The <code>EntryStackItein</code> is the entry template for Stack item 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class EntryStackItem implements Entry { 
public String entrylD; 
public Long position; 
public String content; 

public EntryStackItem{){ 

} 

public EntryStackItem(String entrylD){ 
this.entirylD = entrylD; 

} 

public EntryStackItem(String entrylD, long position. String msg){ 
this.entryID = entrylD; 
this.position = new Long(position); 
this.content = msg; 

} 

public EntryStackItem(String entrylD, long position){ 
this.entryID = entrylD; 
this-position = new Long(position); 

} 

} 

14 EntryStackStatus.java 

package tuplespace.entries; 
import net.jini.core.entry.Entry; 

/ *★ 

* The <code>EntryStackStatus</code> is the entry template for Stack status 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 


public class EntryStackStatus implements Entry { 
public String entrylD; 
public Long s tart Index ,- 
public Long endindex; 
public Long maxSize; 

public EntryStackStatus(){ 

} 

public EntryStackStatus(String entrylD){ 
this.entrylD = entrylD; 


public EntryStackStatus(String entrylD, long maxSize){ 
this.entrylD = entrylD; 
this.maxSize = new Long(maxSize); 
this.startIndex = new Long(O); 
this.endindex = new Long(-l); 


public long getCurSize(){ 

return (endindex.longValue() - startIndex.longValue() +1); 

} 
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public long getMaxSize{){ 
return maxSize.longValue(); 

} 

public long getStartIndexO { 
return startlndex.longValue {); 

} 

public long getEndIndex{){ 

return endindex.longValue (); 

} 


public boolean isEmptyO { 

if(startindex.longValue() > endindex.longValue()) 
return true; 
else 

return false; 

} 

public boolean isFull(){ 

if(maxSize.intValueO <= {endindex.longValue() - startIndex.longValue())) 
return true; 
else 

return false; 

} 

public boolean incrementStartIndexO{ 

if(startindex.longValue() <= endindex.longValue()){ 
startindex = new Long(startindex.intValue()+1); 
return true; 

}else 

return false; 

} 

public boolean incrementEndlndex(>{ 

if(maxSize.longValue() > (endindex.longValue() - startindex.longValue{))) { 
endindex = new Long(endindex.intValue()+1); 
return true; 

>else 

return false; 

} 

} 

15 EntryString.java 

package tuplespace.entries; 
irrport net.jini.core.entry.Entry; 

/ * * 

* The <code>EntryString</code> is the entry template for type - String 

* 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class Entrystring implements Entry { 
public String entrylD; 
public String entrystring; 
public String entryType; 

public Entrystring 0{ 
entryType = "STRING"; 

} 

public Entrystring(String entrylD){ 
entryType = "STRING"; 
this.entrylD = entrylD; 

} 


public Entrystring(String entrylD, String entrystring){ 
entryType = "STRING"; 
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this.entrylD = entrylD; 
this.entrystring = entryString; 

} 

} 

16 SpaceActionHandlejava 

package tuplespace.entries; 

inport java.util-EventListener; 
iitport j ava. awt. event. *; 

* The <cod€>SpaceActionHandler</code> 

* 

* ©author Kin Boon Kwang 

* ©version 1.0/ 01 Oct. 2000 
*/ 

public interface SpaceActionHandler extends ActionListener { 

public void actionPerformed(ActionEvent e); 
public void fireAction(int eventType, String id); 

} 


17 SpaceEventListener.java 

package tuplespace.entries; 

inport tuplespace.entries.*; 
iiport j ava. rmi, server. *; 
iiport j ava. rmi. Remo teExcept ion; 
iiport net. j ini. core, event.*; 
iiport net. j ini. space. JavaSpace; 
iiport j ava. awt. event .ActionListener ; 

y * *■ 

* The <code>SpaceEventListener</code> 

★ 

* ©author Kin Boon Kwang 

* ©version 1.0, 01 Oct. 2000 
*/ 

public class SpaceEventListener implements RemoteEventListener { 
private int eventType; 
private String eventID; 
private JavaSpace space; 
private SpaceActionHandler action; 


public SpaceEventListener(int eventType, String eventID, JavaSpace 
SpaceActionHandler action) throws RemoteException { 
this.eventType = eventType; 
this.eventID = eventID; 
this.space = space; 
this.action = action; 

UnicastRemoteObject.exportObject(this); 

} 

public void notify(RemoteEvent ev) { 
try { 

action.fireAction(eventType, eventID); 

} catch (Exception e) { 
e.printStackTrace() ; 

} 

} 

} 


space. 


241 




TfflS PAGE INTENTIONALLY LEFT BLANK 


242 




INITIAL DISTRIBUTION LIST 

1. Defense Technical Information Center.2 

8725 John J. JCingman Road, Suite 0944 

Ft. Bel voir, VA 22060-6218 

2. Dudley Knox Library.2 

Naval Postgraduate School 

411 Dyer Road 
Monterey, CA 93943-5101 

3. Computer and Information Programs Office.1 

Code 32 

Naval Postgraduate School 
833 Dyer Rd., Room 404 
Monterey, California 93943-5120 

4. Chair, Computer Science Department.1 

Naval Postgraduate School 

833 DyerRd. 

Monterey, California 93943-5118 

5. Dr Luqi.1 

Naval Postgraduate School 

833 DyerRd. 

Monterey, California 93943-5118 

6. Dr Valdis Berzins.3 

Naval Postgraduate School 

833 DyerRd. 

Monterey, California 93943-5118 

7. Dr Ge Jun.2 

Naval Postgraduate School 

833 DyerRd. 

Monterey, California 93943-5118 

8. Mr. Kin Boon Kwang.3 

Depot Road, Defense Technology Tower A, 

Level 20B, Singapore 109679 


243 












